Predefinição:Str left/doc

Esta é uma subpágina de documentação para Predefinição:Str left (Clique na ligação se você quer vê-la diretamente).
Ela contém informações sobre o uso, categorias e outros conteúdos que não são parte da predefinição propriamente dita.

Uso

{{Str left|<string>|<contagem>}}

Cria uma substring de caracteres, resultante do número de caracteres especificado em <contagem>, a partir do início da string cortada (ou seja, a substring retornada terá comprimento especificado em <contagem>, excluindo os caracteres de espaço em branco à esquerda, que são cortados primeiro antes de <contagem> ser invocado).

Se <contagem> for inválido, vazio ou zero, uma string vazia será retornada. Se indefinido, o padrão é 1.

Limitações

Comprimento até 500: A substring máxima para em 500 caracteres, mas não fornece nenhuma mensagem de erro. Apenas 500 caracteres podem ser extraídos mesmo que a <string> seja maior.
Econômica (não usa outras predefinições).

Exemplos

{{ Str left | Lorem ipsum dolor sit amet | 10 }} → Lorem ipsu
{{Str left| Lorem ipsum dolor sit amet | 4 }} → Lore, (observe os espaços iniciais aparados!)
{{ Str left | Lorem ipsum dolor sit amet | 1 }} → L
{{ Str left | Lorem ipsum dolor sit amet | 0 }} →
{{ Str left | Lorem ipsum dolor sit amet | }} →
{{ Str left | Lorem ipsum dolor sit amet }} → L
{{ Str left | Lorem ipsum dolor sit amet | 40 }} → Lorem ipsum dolor sit ametLorem ipsum do
{{ Str left | àçé | 2 }} → àç
Este exemplo está demonstrando a segurança desta predefinição com a codificação UTF-8 (isso deve funcionar agora):

Exemplos das limitações

Todas as limitações de uso, para esta predefinição, mostradas abaixo são causadas pela implementação atual da função {{padleft:}} do analisador usada nesta predefinição, que não filtra seu terceiro parâmetro contendo os caracteres usados para preencher uma string para o comprimento especificado (ele atualmente conta incorretamente os caracteres a serem extraídos da string de preenchimento e mede incorretamente seu comprimento efetivo; além disso, esse parâmetro é limitado a 500 bytes).

Os exemplos a seguir estão demonstrando que esta predefinição não interpreta referências de entidade de caractere como o caractere que elas representam. Ela os trata como vários caracteres e pode deixá-los truncados.

{{ Str left | a c | 3 }} → a&n
A saída "a c" pode ter sido pretendida, mas a entidade de caractere nomeada foi truncada, não deixando nenhum comprimento disponível para o "c" final.
{{ Str left | aBc | 3 }} → a&#
Isso deveria exibir "abc", mas a entidade de caractere nomeada foi truncada, não deixando nenhum comprimento disponível para o "c" final.
{{ Str left | a c | 3 }} → a c
O resultado está correto, como esperado.
{{ Str left | a c | 3 }} → a&#
Este último exemplo deveria ser equivalente ao anterior, mas não é.

Esta predefinição apagará as marcações (tags) nowiki sem contar seu comprimento:

{{ Str left | a<nowiki/>bcd | 3 }} → abc
Retorna três caracteres como esperado
{{ Str left | a<nowiki>E</nowiki>bcd | 3 }} → abc
Retorna três caracteres, mas não aEb como seria de esperar.
{{ Str left | a<nowiki/>bc | 10 }} → abcabcabca
Retorna 10 caracteres como esperado.

Comentários da HTML e as tags de marcação wiki "noinclude", "includeonly" e "onlyinclude" também são ignoradas, porque são pré-processadas nos parâmetros da predefinição, antes de serem incluídas substituindo os parâmetros:

{{ Str left | a<noinclude/>bc | 3 }} → abc
{{ Str left | abc | 3 }} → abc

Observe também que o comprimento especificado fará com que a string de entrada seja preenchida repetindo-a, se esse comprimento for maior que o comprimento da string de entrada:

{{ Str left | Abc. | 10 }} → Abc.Abc.Ab

Dados da predefinição

Uma predefinição para fornecer a substring de <contagem> caracteres a partir do início da string cortada

Parâmetros da predefinição
Parâmetro		Descrição	Tipo	Estado
String	`1`	A string a ser cortada e contada	String	obrigatório
Contagem	`2`	Fornece a ''substring'' de <contagem> caracteres a partir do início da string cortada	Número	obrigatório

Ver também

Bugzilla:22555 (histórico; necessidade de corrigir as funções padleft/padright e fornecer melhores funções do analisador do manipulador de strings) (em inglês)
{{Título em itálico}}
{{minúscula}}

v d e 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	{{Trim}} – Saca qualquer espaço em branco desde o início ao final. {{Primeira palavra}} – Recorta até ao primeiro espaço. {{Última palavra}} – Recorta a última palavra, depois do último espaço. {{Remover primeira palavra}} – Elimina tudo antes do primeiro espaço. {{Str letter/trim}} - Recorta até às primeiras letras. {{Str number/trim}} - Recorta até aos primeiros números.
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	{{#invoke:String\|function}} Ajuda: Palavras mágicas – Sobre `{{padleft:\|}}`. Ajuda: Extensão Parsers Função (modificadores de funções) – Sobre `{{#titleparts:\|}}, {{#expr:\|}}, {{#ifeq:\|}},` etc.
Categoria:!Predefinições de manipulação de cadeias m:Category:String templates Commons:Category:String manipulation templates