Predefinição:Substituir

{{{1}}}

Documentação da predefinição[ver] [editar] [histórico] [purgar]

Esta predefinição usa Lua:

Módulo:String

A meta-predefinição {{substituir}} retorna um texto filtrado pelo que quer substituir.

Uso

editar

Este modelo vale para substituir numa cadeia de texto os caracteres dados na <busca> pelos que se dão em <substituição>. Também se pode dar o contagem de substituições que se têm de realizar e se se ignora este parâmetro substituir-se-ão todas as ocorrências. Por padrão a cadeia de caracteres (string) da busca será tomada de forma literal mas pode-se dar opcionalmente o parâmetro plano com o valor false e nesse caso será tomada como padrões de Lua (um formato de expressões regulares)

Sintaxe

{{Substituir|<cadeia>|<busca>|<substituir> [| contagem = n|plano = (true/false)]}}

Exemplo

editar

Sem usar o parâmetro número

{{Substituir|Um, dois, dois, três, dois, quatro, cinco, doisdois|dois|nove}} → Um, nove, nove, três, nove, quatro, cinco, dosdos

Usando o parâmetro número

{{Substituir|Um, dois, dois, três, dois, quatro, cinco, doisdois|dois|nove|número = 2}} → Um, nove, nove, três, dois, quatro, cinco, doisdois

Usando padrões Lua (expressões regulares)

{{Substituir|O numero 5|(%D*)%d|%1 Nove|plano=false}} → O numero 5

Template data

editar

Este modelo vale para substituir numa cadeia de texto os caracteres dados na <busca> pelos que se dão em <substituição>.

Parâmetros da predefinição[Editar dados da predefinição]
Parâmetro		Descrição	Tipo	Estado
Cadeia	`1`	sem descrição	String	obrigatório
Busca	`2`	sem descrição	String	obrigatório
Substituição	`3`	sem descrição	String	obrigatório
Número de substituições	`contagem`	O número de substituições que se têm de realizar e se se ignora este parâmetro substituir-se-ão todas as ocorrências.	Número	opcional
Literal ou expressão regular?	`plano`	Estabelecer em false se quer-se usar expressões regulares. Padrão false Exemplo false	Booliano	opcional

Ver também

editar

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

A documentação acima é transcluída de Predefinição:Substituir/doc. (editar | histórico)
Editores podem experimentar nas páginas de teste (criar | espelhar) e de exemplos para testes (criar) desta predefinição.
Por favor adicione categorias à subpágina /doc. Subpáginas desta predefinição.