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 (um formato de expressões regulares)

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

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