Matcher.ReplaceAll Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Sobrecargas
ReplaceAll(IFunction) |
Reemplaza cada subsecuencia de la secuencia de entrada que coincide con el patrón con el resultado de aplicar la función de reemplazo dada al resultado coincidente de este buscador de coincidencias correspondiente a esa subsecuencia. |
ReplaceAll(String) |
Reemplaza todas las subsecuencias de la secuencia de entrada que coincidan con el patrón con la cadena de reemplazo especificada. |
ReplaceAll(IFunction)
Reemplaza cada subsecuencia de la secuencia de entrada que coincide con el patrón con el resultado de aplicar la función de reemplazo dada al resultado coincidente de este buscador de coincidencias correspondiente a esa subsecuencia.
[Android.Runtime.Register("replaceAll", "(Ljava/util/function/Function;)Ljava/lang/String;", "", ApiSince=34)]
public string ReplaceAll (Java.Util.Functions.IFunction replacer);
[<Android.Runtime.Register("replaceAll", "(Ljava/util/function/Function;)Ljava/lang/String;", "", ApiSince=34)>]
member this.ReplaceAll : Java.Util.Functions.IFunction -> string
Parámetros
- replacer
- IFunction
Función que se va a aplicar al resultado de coincidencia de este buscador de coincidencias que devuelve una cadena de reemplazo.
Devoluciones
La cadena construida reemplazando cada subsecuencia coincidente por el resultado de aplicar la función de reemplazo a esa subsecuencia coincidente, sustituyendo las subsecuencias capturadas según sea necesario.
- Atributos
Comentarios
Reemplaza cada subsecuencia de la secuencia de entrada que coincide con el patrón con el resultado de aplicar la función de reemplazo dada al resultado coincidente de este buscador de coincidencias correspondiente a esa subsecuencia. Las excepciones producidas por la función se retransmiten al autor de la llamada.
Este método restablece primero este buscador de coincidencias. A continuación, examina la secuencia de entrada que busca coincidencias del patrón. Los caracteres que no forman parte de ninguna coincidencia se anexan directamente a la cadena de resultado; Cada coincidencia se reemplaza en el resultado por la aplicación de la función replacer que devuelve una cadena de reemplazo. Cada cadena de reemplazo puede contener referencias a subsecuencias capturadas como en el #appendReplacement appendReplacement
método .
Tenga en cuenta que las barras diagonales inversas (\
) y los signos de dólar ($
) en una cadena de reemplazo pueden hacer que los resultados sean diferentes de si se trataran como una cadena de reemplazo literal. Los signos de dólar se pueden tratar como referencias a subsecuencias capturadas como se describió anteriormente, y las barras diagonales inversas se usan para escapar caracteres literales en la cadena de reemplazo.
Dada la expresión dog
regular , la entrada "zzzdogzzzdogzzz"
y la función mr -> mr.group().toUpperCase()
, una invocación de este método en un buscador de coincidencias para esa expresión produciría la cadena "zzzDOGzzzDOGzzz"
.
Invocar este método cambia el estado del buscador de coincidencias. Si el buscador de coincidencias se va a usar en operaciones de coincidencia adicionales, primero debe restablecerse.
La función de reemplazo no debe modificar el estado del buscador de coincidencias durante el reemplazo. Este método, según el mejor esfuerzo, producirá una java.util.ConcurrentModificationException
excepción si se detecta dicha modificación.
Se garantiza que el estado de cada resultado de coincidencia que se pasa a la función de reemplazo sea constante solo durante la llamada a la función de reemplazo y solo si la función de reemplazo no modifica el estado de este buscador de coincidencias.
Agregado en 9.
Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código abierto de Android y se usan según los términos descritos en la licencia de atribución de Creative Commons 2.5.
Se aplica a
ReplaceAll(String)
Reemplaza todas las subsecuencias de la secuencia de entrada que coincidan con el patrón con la cadena de reemplazo especificada.
[Android.Runtime.Register("replaceAll", "(Ljava/lang/String;)Ljava/lang/String;", "")]
public string ReplaceAll (string replacement);
[<Android.Runtime.Register("replaceAll", "(Ljava/lang/String;)Ljava/lang/String;", "")>]
member this.ReplaceAll : string -> string
Parámetros
- replacement
- String
Cadena que se va a reemplazar
Devoluciones
Cadena construida reemplazando cada subsecuencia coincidente por la cadena de reemplazo, sustituyendo las subsecuencias capturadas según sea necesario.
- Atributos
Comentarios
Reemplaza todas las subsecuencias de la secuencia de entrada que coincidan con el patrón con la cadena de reemplazo especificada.
Este método restablece primero este buscador de coincidencias. A continuación, examina la secuencia de entrada que busca coincidencias del patrón. Los caracteres que no forman parte de ninguna coincidencia se anexan directamente a la cadena de resultado; Cada coincidencia se reemplaza en el resultado por la cadena de reemplazo. La cadena de reemplazo puede contener referencias a subsecuencias capturadas como en el #appendReplacement appendReplacement
método .
Tenga en cuenta que las barras diagonales inversas (\
) y los signos de dólar ($
) de la cadena de reemplazo pueden hacer que los resultados sean diferentes de si se trataran como una cadena de reemplazo literal. Los signos de dólar se pueden tratar como referencias a subsecuencias capturadas como se describió anteriormente, y las barras diagonales inversas se usan para escapar caracteres literales en la cadena de reemplazo.
Dada la expresión a*b
regular , la entrada "aabfooaabfooabfoob"
y la cadena "-"
de reemplazo , una invocación de este método en un buscador de coincidencias para esa expresión produciría la cadena "-foo-foo-foo-"
.
Invocar este método cambia el estado del buscador de coincidencias. Si el buscador de coincidencias se va a usar en operaciones de coincidencia adicionales, primero debe restablecerse.
Documentación de Java para java.util.regex.Matcher.replaceAll(java.lang.String)
.
Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código abierto de Android y se usan según los términos descritos en la licencia de atribución de Creative Commons 2.5.