Matcher.ReplaceFirst Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Overload
| Nome | Descrizione |
|---|---|
| ReplaceFirst(IFunction) |
Sostituisce la prima sottosequenza della sequenza di input che corrisponde al criterio con il risultato dell'applicazione della funzione replacer specificata al risultato della corrispondenza di questo matcher corrispondente a tale sottosequenza. |
| ReplaceFirst(String) |
Sostituisce la prima sottosequenza della sequenza di input che corrisponde al criterio con la stringa di sostituzione specificata. |
ReplaceFirst(IFunction)
Sostituisce la prima sottosequenza della sequenza di input che corrisponde al criterio con il risultato dell'applicazione della funzione replacer specificata al risultato della corrispondenza di questo matcher corrispondente a tale sottosequenza.
[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 -> stringParametri
- replacer
- IFunction
Funzione da applicare al risultato della corrispondenza di questo matcher che restituisce una stringa di sostituzione.
Valori restituiti
Stringa costruita sostituendo la prima sottosequenza corrispondente con il risultato dell'applicazione della funzione replacer alla sottosequenza corrispondente, sostituendo le sottosequenze acquisite in base alle esigenze.
- Attributi
Commenti
Sostituisce la prima sottosequenza della sequenza di input che corrisponde al criterio con il risultato dell'applicazione della funzione replacer specificata al risultato della corrispondenza di questo matcher corrispondente a tale sottosequenza. Le eccezioni generate dalla funzione replace vengono inoltrate al chiamante.
Questo metodo reimposta prima di tutto questo matcher. Analizza quindi la sequenza di input cercando una corrispondenza del modello. I caratteri che non fanno parte della corrispondenza vengono accodati direttamente alla stringa di risultato; la corrispondenza viene sostituita nel risultato applicando la funzione replacer che restituisce una stringa di sostituzione. La stringa di sostituzione può contenere riferimenti alle sottosequenze acquisite come nel #appendReplacement appendReplacement metodo .
Si noti che le barre rovesciate () e i segni di dollaro (\$) nella stringa di sostituzione possono causare risultati diversi rispetto a quelli considerati come stringa di sostituzione letterale. I segni di dollaro possono essere considerati come riferimenti alle sottosequenze acquisite come descritto in precedenza e le barre rovesciate vengono usate per eseguire l'escape dei caratteri letterali nella stringa di sostituzione.
Data l'espressione dogregolare , l'input "zzzdogzzzdogzzz"e la funzione mr -> mr.group().toUpperCase(), una chiamata di questo metodo su un matcher per tale espressione restituirà la stringa "zzzDOGzzzdogzzz".
Il richiamo di questo metodo modifica lo stato del matcher. Se il matcher deve essere usato in altre operazioni di corrispondenza, deve prima essere reimpostato.
La funzione replacer non deve modificare lo stato del matcher durante la sostituzione. Questo metodo, su base ottimale, genera un'eccezione java.util.ConcurrentModificationException se viene rilevata tale modifica.
Lo stato del risultato della corrispondenza passato alla funzione replacer è garantito che sia costante solo per la durata della chiamata di funzione replacer e solo se la funzione replacer non modifica lo stato del matcher.
Aggiunta in 9.
Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.
Si applica a
ReplaceFirst(String)
Sostituisce la prima sottosequenza della sequenza di input che corrisponde al criterio con la stringa di sostituzione specificata.
[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 -> stringParametri
- replacement
- String
Stringa da usare per la sostituzione
Valori restituiti
Stringa costruita sostituendo la prima sottosequenza corrispondente dalla stringa di sostituzione, sostituendo le sottosequenze acquisite in base alle esigenze
- Attributi
Commenti
Sostituisce la prima sottosequenza della sequenza di input che corrisponde al criterio con la stringa di sostituzione specificata.
Questo metodo reimposta prima di tutto questo matcher. Analizza quindi la sequenza di input cercando una corrispondenza del modello. I caratteri che non fanno parte della corrispondenza vengono accodati direttamente alla stringa di risultato; la corrispondenza viene sostituita nel risultato dalla stringa di sostituzione. La stringa di sostituzione può contenere riferimenti alle sottosequenze acquisite come nel #appendReplacement appendReplacement metodo .
Si noti che le barre rovesciate () e i segni di dollaro (\$) nella stringa di sostituzione possono causare risultati diversi rispetto a quelli considerati come stringa di sostituzione letterale. I segni di dollaro possono essere considerati come riferimenti alle sottosequenze acquisite come descritto in precedenza e le barre rovesciate vengono usate per eseguire l'escape dei caratteri letterali nella stringa di sostituzione.
Dato l'espressione dogregolare , l'input "zzzdogzzzdogzzz"e la stringa "cat"di sostituzione , una chiamata di questo metodo su un matcher per tale espressione restituirà la stringa "zzzcatzzzdogzzz".
Il richiamo di questo metodo modifica lo stato del matcher. Se il matcher deve essere usato in altre operazioni di corrispondenza, deve prima essere reimpostato.
per java.util.regex.Matcher.replaceFirst(java.lang.String).
Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.