Devuelve un valor Boolean que indica el estado del indicador multiline (m) utilizado con una expresión regular. El valor predeterminado es false. Es de sólo lectura.

rgExp.multiline

El argumento requerido rgExp es una instancia del objeto RegExp.

Comentarios

La propiedad multiline devuelve true si se establece el indicador multiline para una expresión regular y devuelve false en caso contrario. La propiedad multiline es true si el objeto de expresión regular se creó con el indicador m.

Si multiline es false, "^" coincide con la posición del principio de una cadena y "$" coincide con la posición del final de una cadena. Si multiline es true, "^" coincide con la posición del principio de una cadena así como con la posición siguiente a "\n" o "\r"; "$" coincide con la posición del principio de la cadena y la posición anterior a "\n" o "\r".

Ejemplo

El ejemplo siguiente ilustra el comportamiento de la propiedad multiline. Si se pasa "m" a la función mostrada a continuación, la palabra "mientras" se reemplaza con la palabra "y". Esto se debe a que se ha establecido el indicador multiline y la palabra "mientras" está al principio de la línea después del carácter de nueva línea. El indicador multiline permite que la búsqueda se realice en cadenas de varias líneas.

Esta función devuelve una cadena con una tabla que muestra la condición de los indicadores de expresiones regulares permitidos, g, i y m. La función también devuelve una cadena en la que se han realizado todas las sustituciones.

function RegExpPropDemo(flag){
   if (flag.match(/[^gim]/))          //Comprueba la validez del indicador.
     return("El indicador especificado no es válido");
   var r, re, s                       //Declara las variables.
   var ss = "El hombre golpea la pelota con el bate.";
   ss += "\nmientras el extremo recibe la pelota con el guante.";
   re = new RegExp("^mientras",flag);    //Especifica el patrón de búsqueda.
   r = ss.replace(re, "y");         //Reemplaza "mientras" con "y".
   s = "Valores de la propiedad Regular Expression:\n\n"
   s += "global  ignoreCase  multiline\n"
   if (re.global)                     //Prueba el indicador global.
     s += " True     ";
   else
     s += "False     ";
   if (re.ignoreCase)                 //Prueba el indicador ignoreCase.
     s += " True  ";
   else
     s += "False  ";
   if (re.multiline)                  //Prueba el indicador multiline.
     s += "     True     ";
   else
     s += "     False   ";
   s += "\n\nLa cadena resultante es:\n\n" + r;
   return(s);                         //Devuelve la cadena sustituida
}

Requisitos

Versión 5

Consulte también

Propiedad global | Propiedad ignoreCase | Sintaxis de expresión regular

Se aplica a: Objeto RegExp