Ir para o conteúdo

Predefinição:Str len/doc

De Wiki TokuDrive
Revisão de 09h41min de 28 de junho de 2026 por Tavoraadmin (discussão | contribs) (Importando predefinição/módulo da Wikipédia em português para manter layout)
(dif) ← Edição anterior | Revisão atual (dif) | Versão posterior → (dif)

{{#invoke:Message box|mbox}} {{#invoke:Message box|ombox}} {{#invoke:Lua banner|main}} 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 {{safesubst:#invoke:String|len|s=}}
{{str len|}} retorna {{safesubst:#invoke:String|len|s=}}
{{str len| }} retorna {{safesubst:#invoke:String|len|s= }}

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 {{safesubst:#invoke:String|len|s= ab cde }}
{{str len| 1234567 }} retorna {{safesubst:#invoke:String|len|s= 1234567 }}
{{str len| café åäö }} retorna {{safesubst:#invoke:String|len|s= café åäö }}

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.

Ver também

Página Predefinição:Módulo:Navbox/styles.css não tem conteúdo.{{#invoke:Navbox|navbox}}