Saltar para o conteúdo

Predefinição:Str mid/doc

Wikisource, a biblioteca livre

Descrição

[editar]

Caracteres na cadeia fonte são contados: o primeiro é o índice 1, o último é comprimento da cadeia. A subcadeia pedida pode ser definida por estes dois índices. Também, a subcadeia pode ser definida por um índice, e o comprimento da subcadeia. As opções são: {{str mid|<string>|<índice do primeiro caractere>|<comprimento da subcadeia>|<índice do último caractere>}} Ela devolve parte da <cadeia>, começando na posição com caractere índice, comprimento <sub-comprimento>, último caractere devolvido é o fim do índice.

  • {{str mid|Abcdefghijklmnopqrstuvwxyz|5|3}} → efg

Se o parâmetro 2 for omitido, o início é do caractere 1:

  • {{str mid|Abcdefghijklmnopqrstuvwxyz||5}} → Abcde

Se o parâmetro 3 é omitido, o resto inteiro do índice é devolvido:

  • {{str mid|Abcdefghijklmnopqrstuvwxyz|15}} → opqrstuvwxyz

Contar desde o fim

[editar]

Ao definir um valor negativo, o índice é contado desde o fim:

  • {{str mid|Abcdefghijklmnopqrstuvwxyz|-7|4}} → tuvw
  • {{str mid|Abcdefghijklmnopqrstuvwxyz|-7}} → tuvwxyz

Em vez de tamanho subcadeia, use índice para último caractere

[editar]

Ao usar parâmetro 4, um número, se não pedir um comprimento de uma subcadeia, mas pelo último caractere (como foi contado desde o início da cadeia definida):

  • {{str mid|Abcdefghijklmnopqrstuvwxyz|5||7}} → efg

Espaços são mantidos

[editar]

Na subcadeia devolvida, espaços são mantidos:

  • >{{str mid|Eu gosto disto.|2|6}}< → >u gost<

Mas a cadeia original é mantida:

  • >{{str mid| Eu gosto disto. |2|6}}< → >u gost<

Mensagens de erro

[editar]

Quando os valores (ou param2 ou comprimento da subcadeia) está fora dos valores da cadeia, é devolvido um erro:

  • {{str mid|Abcdefghijklmnopqrstuvwxyz|30}} → String Module Error: String subset index out of range
  • {{str mid|Abcdefghijklmnopqrstuvwxyz|0|45}} → efghijklmnopqrstuvwxyz

A mensagem de erro pode ser suprimida ao usar ignore errors. Uma cadeia vazia é devolvida:

  • {{str mid|Abcdefghijklmnopqrstuvwxyz|0|45|ignore errors=true}} → efghijklmnopqrstuvwxyz

Categoria de erros

[editar]
  • no category desliga adicionar a categoria.
  • error category define a categoria que é adicionada no caso de erro.
O padrão é Categoria:!Erros reportados pelo Módulo String.

Ver também

[editar]