Matcher.ReplaceFirst 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
| Nombre | Description |
|---|---|
| ReplaceFirst(IFunction) |
Reemplaza la primera 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. |
| ReplaceFirst(String) |
Reemplaza la primera subsecuencia de la secuencia de entrada que coincide con el patrón con la cadena de reemplazo especificada. |
ReplaceFirst(IFunction)
Reemplaza la primera 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("replaceFirst", "(Ljava/util/function/Function;)Ljava/lang/String;", "", ApiSince=34)]
public string ReplaceFirst(Java.Util.Functions.IFunction replacer);[<Android.Runtime.Register("replaceFirst", "(Ljava/util/function/Function;)Ljava/lang/String;", "", ApiSince=34)>]
member this.ReplaceFirst : Java.Util.Functions.IFunction -> stringPará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 la primera subsecuencia coincidente por el resultado de aplicar la función de reemplazo a la subsecuencia coincidente, sustituyendo las subsecuencias capturadas según sea necesario.
- Atributos
Comentarios
Reemplaza la primera 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 replace se retransmiten al autor de la llamada.
Este método restablece primero este buscador de coincidencias. A continuación, examina la secuencia de entrada buscando una coincidencia del patrón. Los caracteres que no forman parte de la coincidencia se anexan directamente a la cadena de resultado; La coincidencia se reemplaza en el resultado mediante la aplicación de la función de reemplazo que devuelve una 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 dogregular , 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 del resultado de coincidencia pasado 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 Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.
Se aplica a
ReplaceFirst(String)
Reemplaza la primera subsecuencia de la secuencia de entrada que coincide con el patrón con la cadena de reemplazo especificada.
[Android.Runtime.Register("replaceFirst", "(Ljava/lang/String;)Ljava/lang/String;", "")]
public string ReplaceFirst(string replacement);[<Android.Runtime.Register("replaceFirst", "(Ljava/lang/String;)Ljava/lang/String;", "")>]
member this.ReplaceFirst : string -> stringParámetros
- replacement
- String
Cadena que se va a reemplazar
Devoluciones
Cadena construida reemplazando la primera subsecuencia coincidente por la cadena de reemplazo, sustituyendo las subsecuencias capturadas según sea necesario.
- Atributos
Comentarios
Reemplaza la primera subsecuencia de la secuencia de entrada que coincide 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 buscando una coincidencia del patrón. Los caracteres que no forman parte de la coincidencia se anexan directamente a la cadena de resultado; la 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 dogregular , la entrada "zzzdogzzzdogzzz"y la cadena "cat"de reemplazo , una invocación de este método en un buscador de coincidencias para esa expresión produciría la cadena "zzzcatzzzdogzzz".
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.
Java documentación para java.util.regex.Matcher.replaceFirst(java.lang.String).
Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.