Propriedade lastIndex

Artigo
08/25/2010

Retorna a posição do caractere em que a próxima correspondência começa em uma seqüência de caracteres pesquisada.

{RegExp | reArray}.lastIndex

Argumentos

RegExp
Obrigatório.O global RegExp objeto.
reArray
Obrigatório.Uma matriz retornada pelo exec método de um Expressões regulares objeto.

Comentários

The lastIndex propriedade é baseada em zero, isto é, o índice do primeiro caractere é zero. Seu valor inicial é – 1.Seu valor é modificado sempre que for feita uma correspondência correta.

The lastIndex propriedade das RegExp objeto é modificado pela exec e teste métodos de do RegExp objeto e o match, Substituir, and Dividir métodos de do String objeto.

As seguintes regras se aplicam aos valores de lastIndex:

Se não houver nenhuma correspondência, lastIndex é conjunto como -1.
If lastIndex é maior do que o comprimento da seqüência de caracteres, teste and exec falhar e lastIndex é conjunto como -1.
If lastIndex é igual ao comprimento da seqüência de caracteres, as correspondências de expressões regulares se o padrão corresponde a seqüência de caracteres vazia. Caso contrário, a correspondência falhará e lastIndex é redefinido como -1.
Caso contrário, lastIndex é definida para a próxima posição seguindo a correspondência mais recente.

O valor inicial de RegExp.lastIndexpropriedade é – 1.Seu valor é somente leitura e será alterada sempre que uma correspondência bem-sucedida é feita.

Observação:
As propriedades das RegExp objeto não estão disponível quando executado em modo rápido, o padrão para JScript. Para compilar um programa a partir da linha de comando que usa essas propriedades, você deve desativar a opção rápida usando /Fast-.Não é seguro para desativar a opção rápida em ASP.NET Por causa de problemas de threading.

Exemplo

O exemplo a seguir ilustra o uso do lastIndex propriedade. Esta função itera uma seqüência de Pesquisar e imprime o índice and lastIndex valores para cada palavra na seqüência de caracteres.

var src : String = "The rain in Spain falls mainly in the plain.";
var re : RegExp = /\w+/g;
var arr : Array;
while ((arr = re.exec(src)) != null)
   print(arr.index + "-" + arr.lastIndex + "\t" + arr);

A saída deste programa é:

0-3     The
4-8     rain
9-11    in
12-17   Spain
18-23   falls
24-30   mainly
31-33   in
34-37   the
38-43   plain

Requisitos

Versão 3

Aplica-se ao:

Objeto RegExp

Consulte também

Conceitos

Sintaxe de Expressãosões regulares

Referência

Método exec

Compartilhar via