Propriedade global

Retorna um valor Boolean que indica o estado do sinalizador global (g) usado com uma expressão regular.

rgExp.global

Argumentos

  • rgExp
    Obrigatório. Uma instância de um A expressão Regular objeto.

Comentários

O global propriedade é somente leitura e retorna true se o sinalizador global estiver definido para uma expressão regular e retorna false se não for. O valor padrão é false.

O sinalizador global, quando usado, indica que uma pesquisa deverá encontrar todas as ocorrências do padrão dentro da seqüência pesquisada, não apenas aquele primeiro. Isso também é conhecido como correspondência global.

Exemplo

O exemplo a seguir ilustra o uso de global propriedade. Se você passar g na função mostrada abaixo, todas as ocorrências da palavra "o" são substituídos com a palavra "a". Observe que o "O" no início da seqüência de caracteres não é substituída porque o i (ignorar maiúsculas e minúsculas) sinalizador não é passado para a função.

Esta função exibe os valores booleanos que estão associados com os sinalizadores permitido de expressão regular, que são g, i, e m. A função também exibe a seqüência de caracteres com todas as substituições efetuadas.

function RegExpPropDemo(flag){
    // The flag parameter is a string that contains
    // g, i, or m.  The flags can be combined.

    // Check flags for validity.
    if (flag.match(/[^gim]/))
        {
        return ("Flag specified is not valid");
        }

    // Create the string on which to perform the replacement.
    var orig = "The batter hit the ball with the bat ";
    orig += "and the fielder caught the ball with the glove.";

    // Replace "the" with "a".
    var re = new RegExp("the", flag);
    var r = orig.replace(re, "a");        

    // Output the resulting string and the values of the flags.
    print ("global: " + re.global.toString());
    print ("ignoreCase: " + re.ignoreCase.toString());
    print ("multiline: " + re.multiline.toString());
    print ("Resulting String: " + r);
}

RegExpPropDemo("g");

Veja a seguir a saída resultante.

global: true
ignoreCase: false
multiline: false
Resulting String: The batter hit a ball with a bat and a fielder caught a ball with a glove.

Requisitos

Versão 5.5

Se aplica A:

Objeto de expressão regular

Consulte também

Referência

ignoreCase propriedade

Propriedade MultiLine

Conceitos

Sintaxe de expressão regular