Predefinição:Str mid

• {{Str mid}}
• {{Str mid/core}}
• {{Str mid/Exemplo para teste}}

Documentação da predefinição[ver] [editar] [histórico] [purgar]

Descrição

Caracteres na cadeia fonte são contados: o primeiro é o índice Predefinição:Code, o último é Predefinição:Code. 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}} → efghijklmnopqrstuvwxyz

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

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

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

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

Contar desde o fim

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

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

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

Ao usar parâmetro Predefinição:Parâmetro, 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}} → efghijklmnopqrstuvwxyz

Espaços são mantidos

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

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

Mas a cadeia original é mantida:

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

Mensagens de erro

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

• {{str mid|Abcdefghijklmnopqrstuvwxyz|30}} →
• {{str mid|Abcdefghijklmnopqrstuvwxyz|0|45}} → efghijklmnopqrstuvwxyz

A mensagem de erro pode ser suprimida ao usar Predefinição:Parâmetro. Uma cadeia vazia é devolvida:

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

Categoria de erros

• Predefinição:Parâmetro desliga adicionar a categoria.
• Predefinição:Parâmetro define a categoria que é adicionada no caso de erro.
  

O padrão é Categoria:!Erros reportados pelo Módulo String.

Ver também