Origem: Wikipédia, a enciclopédia livre.
 | Esta predefinição usa Lua:
|
Descrição
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
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
Ao usar parâmetro |4=n, 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
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
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=true. Uma cadeia vazia é devolvida:
- {{str mid|Abcdefghijklmnopqrstuvwxyz|0|45|ignore errors=true}} → efghijklmnopqrstuvwxyz
Categoria de erros
|no category=true desliga adicionar a categoria.|error category=[[Categoria:O nome da sua categoria]] define a categoria que é adicionada no caso de erro.
- O padrão é Categoria:!Erros reportados pelo Módulo String.
Ver também
Modificadores de cadeias |
|---|
| Recortar e recontar |
- {{Str mid}} – Devolve uma subcadeia, especificando sua posição e longitude.
- {{Truncar}} – Retorna um certo número especificado de caracteres.
- {{Str left}} – Para recortar um número determinado de caracteres, ou duplicar a cadeia num número especificado.
- {{Str crop}} – Para recortar um número especificado de caracteres do final.
- {{Chop head and tail}} – Para recortar um número especificado de caracteres de início e fim.
- {{Str right}} – Para recortar o primeiro número de caracteres especificado.
- {{Str rightc}} – Devolve um número de caracteres desde o final e se a cadeia está vazia devolve um parâmetro.
- {{Str rightmost}} – Para recortar até ao último número de caracteres.
- {{Str sub}} – Devolve um número específico de caracteres, a partir de un índice inicial e o número de caracteres a devolver.
- {{Str sub new}} – Devolve un número específico de caracteres, a partir de um índice inicial e um índice final.
- {{Str index}} – Devolve o caractere na posição numérica de uma cadeia com respeito à cadeia analisada.
|
|---|
| Marcação | |
|---|
| Inserir cadeias |
- {{Repete}} – Repete caracteres da cadeia de caracteres um número de vezes.
- {{Substituir}} – Devolve a cadeia, depois de substituir todas as ocorrências de uma cadeia definida por outra cadeia.
- {{Strloc insert}} – Insere uma cadeia em lugar de caracteres strloc ou agrega sem strloc <= 0.
- {{Strloc prefix}} – Extrai uma cadeia do prefixo até a união strloc ou a cadeia inteira sem strloc <= 0.
- {{Str rep}} – Devolve a cadeia, depois de trocar a primeira aparição de uma cadeia especificada com outra cadeia.
|
|---|
| Comparação de longitude de cadeias: |
- {{Str len}} – Devolve a longitude de uma cadeia de texto.
- {{iflenge}} – Se a longitude maior que ou igual a.
- {{Str ≥ len}} – Comprova se uma cadeia é "mais larga ou igual" ou "mais curta" de um determinado tamanho.
- {{Str ≤ len}} – Comprova se uma cadeia é "mais curta ou igual" ou "mais larga" de um determinado tamanho.
- {{Str ≠ len}} – Comprova se uma cadeia é "diferente" ou "igual" de um tamanho determinado.
- {{Str ≤ ≥ len}} – Comprova se uma cadeia é "mais curta", "igual", ou "mais larga" de um tamanho determinado.
|
|---|
| Analizar cadeias |
- {{Str endswith}} – Comprova se uma cadeia termina com uma cadeia determinada.
- {{Str find}} – Devolve a posição numérica de uma cadeia dada respeito a cadeia analisada.
- {{Strfind short}} – Devolve a posição numérica de uma cadeia dada respeito a cadeia analisada.
- {{Str find0}} – Zero de base na subcadeia de busca.
- {{Str sub find}} – Busca uma subcadeia em uma cadeia dada com o desfasamento.
- {{ASCII code}} – Devolve o valor ASCII de um só caractere.
- {{Str letter}} – Devolve o número de letras seguidas que existem no início da cadeia.
- {{Str number}} – Devolve o número de números seguidos que existem no início da cadeia.
- {{Str gtr str}} – Compara duas cadeias por ordem alfabética e devolve um valor em consequência.
|
|---|
| Predefinições específicas |
- {{PAGENAMEBASE}} Título sem desambiguação – Recorta o texto entre parênteses ao final de uma cadeia. (desambiguação).
- {{Delink}} – Elimina ligações wiki entre colchetes (wikicódigo).
|
|---|
| Questões técnicas | |
|---|
|
