Predefinição:Substituir
{{{1}}}
Esta predefinição é usada em mais de 76 000 páginas e as alterações em seu conteúdo serão amplamente notadas. Por favor, teste as alterações na subpágina de testes desta predefinição, em sua subpágina da predefinição de testes ou na subpágina de testes em seu espaço usuário. Considere discutir mudanças na página de discussão antes de implementá-las. |
Esta predefinição usa Lua: |
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â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.
| Booliano | opcional |
Ver também
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. |