Predefinição:Substituir/doc

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

Uso

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.

Sintaxe

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

Exemplo

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, novenove

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 nove

Template data

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

Parâmetro		Descrição	Tipo	Estado
Cadeia	1	Texto original que deve ser alterado	String	obrigatório
Busca	2	Termo (ou termos) que deseja ser substituído	String	obrigatório
Substituição	3	Qual termo deve substituir os definidos anteriormente	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