Compartilhar via


substituir Método

Retorna uma cópia de uma seqüência de caracteres com texto substituído usando uma seqüência de expressão ou Pesquisar regular.

function replace(rgExp : RegExp, replaceText : String) : String

Argumentos

  • rgExp
    Obrigatório.Uma instância de um Expressões regulares objeto contendo o padrão de expressão regular e sinalizadores aplicáveis.Também pode ser um String o objeto ou literal. If rgExp não é uma instância de um Expressões regulares objeto, ele é convertido em uma seqüência de caracteres e é feita uma Pesquisar exata para os resultados; nenhuma tentativa de converter a seqüência de caracteres em uma expressão regular.

  • replaceText
    Obrigatório.A String objeto ou que contém o texto a substituir para cada correspondência correta da literal de cadeia de caracteres rgExp no objeto de seqüência de caracteres corrente. No JScript 5.5 ou posterior, o replaceText argumento também pode ser uma função que retorna o texto de substituição.

Comentários

O resultado do Substituir método é uma cópia do objeto de seqüência de caracteres corrente após terem sido feitas substituições especificadas.

Qualquer uma das seguintes variáveis de correspondência pode ser usado para identificar a correspondência mais recente e a seqüência de caracteres de onde ele veio.As variáveis de correspondência podem ser usadas na substituição de texto em que a seqüência de caracteres de substituição tem seja determinado dinamicamente.

Caracteres

Significado

$$

$ (JScript 5.5 ou posterior)

$&

Especifica a parte do objeto corrente cadeia de caracteres que correspondem o padrão de todo.(JScript 5.5 ou posterior)

$`

Especifica a parte do objeto seqüência corrente que precede a correspondência descrita por $&.(JScript 5.5 ou posterior)

$'

Especifica a parte do objeto corrente cadeia de caracteres que segue a correspondência descrita por $&.(JScript 5.5 ou posterior)

$n

The nth capturados submatch, onde n é um único dígito decimal de 1 a 9.(JScript 5.5 ou posterior)

$nn

The nnth capturados submatch, onde nn é um número decimal de dois dígitos de 01 a 99.(JScript 5.5 ou posterior)

If replaceText é uma função para cada substring correspondida que a função é chamada com o seguinte m + 3 argumentos onde m é o número de captura parênteses no à esquerdargExp. O primeiro argumento é substring que correspondeu.O próximo m argumentos são todas as capturas que resultou da Pesquisar.Argumento m + 2 é o deslocamento dentro do objeto de seqüência de caracteres corrente onde ocorreu a correspondência e de argumento m + 3 é o objeto de seqüência de caracteres corrente.O resultado é o valor de seqüência de caracteres que resultados da substituindo cada substring correspondida com o valor retornado correspondente da telefonar de função.

The Substituir método atualiza as propriedades do global RegExp objeto.

Exemplo

O exemplo a seguir ilustra o uso do Substituir método para substituir a primeira caso da palavra "The" com a palavra "a". Observe que ele substitui apenas a primeira instância de "A" como o padrão é sensível a diferenciar diferenciar maiúsculas de minúsculas.

function ReplaceDemo(){
   var r, re;                   //Declare variables.
   var ss = "The man hit the ball with the bat.\n";
   ss += "while the fielder caught the ball with the glove.";
   re = /The/g;                //Create regular expression pattern.
   r = ss.replace(re, "A");    //Replace "The" with "A".
   return(r);                  //Return string with replacement made.
}

Além disso, a Substituir método também pode substituir subexpressions no padrão.O exemplo a seguir troca cada emparelhar de palavras na seqüência de caracteres.

function ReplaceDemo(){
   var r, re;                      //Declare variables.
   var ss = "The rain in Spain falls mainly in the plain.";
   re = /(\S+)(\s+)(\S+)/g;        //Create regular expression pattern.
   r = ss.replace(re, "$3$2$1");   //Swap each pair of words.
   return(r);                      //Return resulting string.
}

O exemplo a seguir, que funciona no JScript 5.5 e posteriores, realiza um Fahrenheit para Celsius conversão, ilustra usando uma função sistema autônomo replaceText. Para ver como essa função funciona, passe em uma seqüência de caracteres contendo um número seguido imediatamente por um "F" (por exemplo, "água boils em 212").

function f2c(s) {
  var test = /(\d+(\.\d*)?)F\b/g;    //Initialize pattern.
  return(s.replace
    (test,
      function($0,$1,$2) { 
        return((($1-32) * 5/9) + "C");
      }
    )
  );
}
document.write(f2c("Water freezes at 32F and boils at 212F."));

Requisitos

Versão 1

Aplica-se ao:

Objeto de seqüência de caracteres

Consulte também

Referência

Método exec

corresponde ao método

Objeto RegExp

Método de Pesquisar

método de teste