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