Predefinição:Str mid/doc
 | Esta é uma subpágina de documentação para a Predefinição:Str mid. Ela contém informações sobre o seu uso, categorias, bem como todo o conteúdo que não faz parte da predefinição original. |
 | Esta predefinição usa Lua: |
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}} → String Module Error: String subset index out of range
- {{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
Predefinição:Navegação modificadores de cadeias