Predefinição:Substituir/doc

{{#invoke:Message box|mbox}} {{#invoke:Message box|ombox}} {{#invoke:Lua banner|main}} 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}} → {{safesubst:#invoke:String|replace|source=Um, dois, dois, três, dois, quatro, cinco, dosdos|dois|nove|count=}}

Usando o parâmetro número

• {{Substituir|Um, dois, dois, três, dois, quatro, cinco, doisdois|dois|nove|número = 2}} → {{safesubst:#invoke:String|replace|source=Um, dois, dois, três, dois, quatro, cinco, doisdois|dois|nove|count=2}}

Usando padrões Lua (expressões regulares)

• {{Substituir|O numero 5|(%D*)%d|%1 Nove|plano=false}} → {{safesubst:#invoke:String|replace|source=O numero 5|(%D*)%d|%1 nove|count=}}

Template data

<templatedata> {

   "params": {
       "1": {
           "label": "Cadeia",
           "type": "string",
           "required": true
       },
       "2": {
           "label": "Busca",
           "type": "string",
           "required": true
       },
       "3": {
           "label": "Substituição",
           "type": "string",
           "required": true
       },
       "contagem": {
           "label": "Número de substituições",
           "description": "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.",
           "type": "number"
       },
       "plano": {
           "label": "Literal ou expressão regular?",
           "description": "Estabelecer em false se quer-se usar expressões regulares.",
           "example": "false",
           "type": "boolean",
           "default": "false"
       }
   },
   "description": "Este modelo vale para substituir numa cadeia de texto os caracteres dados na <busca> pelos que se dão em <substituição>. "

} </templatedata>

Ver também

{{#invoke:Navbox|navbox}}