Predefinição:Str len/doc
 | Esta é uma subpágina de documentação para a Predefinição:Str len. 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: |
A meta-predefinição {{str len}} obtém uma string como parâmetro e retorna o seu comprimento. Pode contar até 500 caracteres, e retorna 500 para strings mais longas.
Nota! Para a maioria dos casos é muito mais fácil e consome muito menos recursos do servidor usar {{str ≥ len}} ou uma de suas predefinições irmãs. Veja a seção ver também abaixo.
Exemplos
Caso o parâmetro é vazio ou indefinido é considerado de comprimento zero:
{{str len}}retorna 0{{str len|}}retorna 0{{str len| }}retorna 0
Conta o comprimento corretamente, mesmo se a string contém espaços, pareça um número, ou contenha caracteres especiais:
{{str len| ab cde }}retorna 6
{{str len| 1234567 }}retorna 7
{{str len| café åäö }}retorna 8
Pode medir strings de até 500 caracteres, e retorna 500 para strings mais longas que isso:
{{str len| 499-characters... }}retorna 499{{str len| 1000-characters... }}retorna 500
Datalhes técnicos
O MediaWiki não possui funções de análise ou palavras mágicas para medir comprimentos de cadeias de caracteres e a medição usando códigos em predefinições consome recursos do servidor. Então esta predefinição foi tão optimizada quanto possível, mas deve-se considerar o uso da {{str ≥ len}} que é mais fácil e menos custosa aos servidores.
Histórico
Antigamente, esta predefinição chamava a {{str len/core}} para fazer o trabalho. Atualmente o processamento é feito através de Lua e a implementação antiga é mantida por motivos históricos somente.