Predefinição:Substituir/doc

Wikisource, a biblioteca livre

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

ParâmetroDescriçãoTipoEstado
Cadeia1

sem descrição

Stringobrigatório
Busca2

sem descrição

Stringobrigatório
Substituição3

sem descrição

Stringobrigatório
Número de substituiçõescontagem

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úmeroopcional
Literal ou expressão regular?plano

Estabelecer em false se quer-se usar expressões regulares.

Padrão
false
Exemplo
false
Boolianoopcional

Ver também[editar]