StringSearch Classe
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.
StringSearch è un oggetto SearchIterator che fornisce la ricerca di testo sensibile alla lingua in base alle regole di confronto definite in un RuleBasedCollator oggetto .
[Android.Runtime.Register("android/icu/text/StringSearch", ApiSince=24, DoNotGenerateAcw=true)]
public sealed class StringSearch : Android.Icu.Text.SearchIterator[<Android.Runtime.Register("android/icu/text/StringSearch", ApiSince=24, DoNotGenerateAcw=true)>]
type StringSearch = class
inherit SearchIterator- Ereditarietà
- Attributi
Commenti
StringSearch è un oggetto SearchIterator che fornisce la ricerca di testo sensibile alla lingua in base alle regole di confronto definite in un RuleBasedCollator oggetto . StringSearch garantisce che l'eccentricità del linguaggio possa essere gestita, ad esempio per il collator tedesco, i caratteri ß e SS verrà confrontato se viene scelto di ignorare il caso. Per altre informazioni, vedere il documento "ICU Collation Design Document".
Sono disponibili 2 opzioni di corrispondenza per selection:<br> Let S' essere la sottostringa di una stringa di testo S tra gli offset iniziale e finale [inizio, fine]. <br> Una stringa di pattern P corrisponde a una stringa di testo S in corrispondenza degli offset [inizio, fine] se
option 1. Some canonical equivalent of P matches some canonical equivalent
of S'
option 2. P matches S' and if P starts or ends with a combining mark,
there exists no non-ignorable combining mark before or after S?
in S respectively.
Opzione 2. è l'impostazione predefinita.
Questa ricerca include API simili a quelle di altri meccanismi di iterazione del testo, ad esempio gli iteratori di interruzione in BreakIterator. Usando queste API, è facile analizzare il testo cercando tutte le occorrenze di un determinato modello. Questo iteratore di ricerca consente di cambiare direzione chiamando un #reset oggetto seguito da un #next oggetto o #previous. Anche se una modifica della direzione può verificarsi senza chiamare #reset prima, questa operazione presenta una penalità di velocità. I risultati della corrispondenza nella direzione in avanti corrisponderanno alle corrispondenze dei risultati nella direzione indietro nell'ordine inverso
SearchIterator fornisce API per specificare la posizione iniziale all'interno della stringa di testo da cercare, ad esempio SearchIterator#setIndex setIndex, SearchIterator#preceding preceding e SearchIterator#following following. Poiché la posizione iniziale verrà impostata come specificato, tenere presente che ci sono alcuni punti di pericolo in cui la ricerca può eseguire il rendering di risultati non corretti: <ul><li> In mezzo a una sottostringa che richiede la normalizzazione.
<li> Se si trova la corrispondenza seguente, la posizione non deve essere il secondo carattere che richiede lo scambio con il carattere precedente. Viceversa, se si trova la corrispondenza precedente, la posizione da cui eseguire la ricerca non deve essere il primo carattere che richiede lo scambio con il carattere successivo. Ad esempio, alcuni caratteri thai e lao richiedono lo scambio.
<li> Se viene trovata una corrispondenza di criterio seguente, qualsiasi posizione all'interno di una sequenza di appalto tranne la prima avrà esito negativo. Viceversa, se viene trovata una corrispondenza del criterio precedente, un punto iniziale non valido sarà qualsiasi carattere all'interno di una sequenza di appalto tranne l'ultimo.
</ul>
Un BreakIterator oggetto può essere utilizzato se si desiderano solo corrispondenze a interruzioni logiche. L'uso di un BreakIterator consentirà di ottenere risultati che corrispondono esattamente ai limiti specificati da BreakIterator. Ad esempio, il criterio "e" non verrà trovato nella stringa "\u00e9" se viene usato un iteratore di interruzione di caratteri.
Sono disponibili opzioni per gestire le corrispondenze sovrapposte. Ad esempio, in inglese, le corrispondenze sovrapposte generano il risultato 0 e 2 per il modello "abab" nel testo "ababab", dove corrispondenze che si escludono a vicenda produce solo il risultato di 0.
Sono disponibili anche opzioni per implementare la "ricerca asimmetrica" come descritto in Algoritmo di confronto Unicode UTS #10, in particolare i valori ElementComparisonType.
Sebbene gli attributi del collator vengano presi in considerazione durante l'esecuzione delle corrispondenze, non sono disponibili API per l'impostazione e il recupero degli attributi. Questi attributi possono essere impostati ottenendo il collator da #getCollator e usando le API in RuleBasedCollator. Infine, è necessario chiamare l'aggiornamento StringSearch ai nuovi attributi #reset del collator.
Restrizione: <br> Attualmente non sono presenti caratteri compositi costituiti da un carattere con classe combinata > 0 prima di un carattere con la classe combinata == 0. Tuttavia, se tale carattere esiste in futuro, StringSearch non garantisce i risultati per l'opzione 1.
Consultare la SearchIterator documentazione per informazioni su e esempi su come usare le istanze di questa classe per implementare la ricerca di testo.
Si noti che StringSearch non deve essere sottoclassato.
per android.icu.text.StringSearch.
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.
Costruttori
| Nome | Descrizione |
|---|---|
| StringSearch(String, ICharacterIterator, Locale) |
Inizializza l'iteratore per usare le regole specifiche della lingua e le regole dell'iteratore definite nelle impostazioni locali dell'argomento per cercare il criterio di argomento nel testo di destinazione dell'argomento. |
| StringSearch(String, ICharacterIterator, RuleBasedCollator, BreakIterator) |
Inizializza l'iteratore per usare le regole specifiche della lingua definite nel collator dell'argomento per cercare il criterio di argomento nel testo di destinazione dell'argomento. |
| StringSearch(String, ICharacterIterator, RuleBasedCollator) |
Inizializza l'iteratore per usare le regole specifiche della lingua definite nel collator dell'argomento per cercare il criterio di argomento nel testo di destinazione dell'argomento. |
| StringSearch(String, ICharacterIterator, ULocale) |
Inizializza l'iteratore per usare le regole specifiche della lingua e le regole dell'iteratore definite nelle impostazioni locali dell'argomento per cercare il criterio di argomento nel testo di destinazione dell'argomento. |
| StringSearch(String, String) |
Inizializza l'iteratore per usare le regole specifiche della lingua e le regole dell'iteratore definite nelle impostazioni locali predefinite per cercare il criterio di argomento nel testo di destinazione dell'argomento. |
Campi
| Nome | Descrizione |
|---|---|
| Done |
DONE viene restituito da previous() e next() dopo che tutte le corrispondenze valide sono state restituite e da first() e last() se non sono presenti corrispondenze. (Ereditato da SearchIterator) |
Proprietà
| Nome | Descrizione |
|---|---|
| BreakIterator |
Restituisce l'oggetto BreakIterator utilizzato per limitare gli indici in corrispondenza dei quali vengono rilevate corrispondenze. -oppure- Impostare l'oggetto BreakIterator che verrà usato per limitare i punti in corrispondenza dei quali vengono rilevate corrispondenze. (Ereditato da SearchIterator) |
| Canonical |
Determina se sono impostate corrispondenze canoniche (opzione 1, come descritto nella documentazione della classe). -oppure- Impostare la modalità di corrispondenza canonica. |
| Class |
Restituisce la classe di runtime di questo |
| Collator |
Ottiene l'oggetto |
| Handle |
Handle per l'istanza di Android sottostante. (Ereditato da Object) |
| Index |
Da aggiungere |
| JniIdentityHashCode |
|
| JniPeerMembers |
|
| MatchedText |
Restituisce il testo corrispondente alla chiamata più recente a |
| MatchLength |
Restituisce la lunghezza del testo nella stringa che corrisponde al criterio di ricerca. (Ereditato da SearchIterator) |
| MatchStart |
Restituisce l'indice alla corrispondenza nella stringa di testo in cui è stata eseguita la ricerca. (Ereditato da SearchIterator) |
| Overlapping |
Restituisce true se la proprietà sovrapposta è stata impostata. -oppure- Determina se vengono restituite corrispondenze sovrapposte. (Ereditato da SearchIterator) |
| Pattern |
Restituisce il modello per il quale |
| PeerReference |
|
| Target |
Restituisce il testo della stringa in cui eseguire la ricerca. -oppure- Impostare il testo di destinazione in cui eseguire la ricerca. (Ereditato da SearchIterator) |
| TargetText |
Testo di destinazione per la ricerca. (Ereditato da SearchIterator) |
| ThresholdClass |
|
| ThresholdType |
|
Metodi
| Nome | Descrizione |
|---|---|
| Clone() |
Crea e restituisce una copia di questo oggetto. (Ereditato da Object) |
| Dispose() |
|
| Dispose(Boolean) |
|
| Equals(Object) |
Indica se un altro oggetto è "uguale a" questo. (Ereditato da Object) |
| First() |
Restituisce il primo indice in corrispondenza del quale il testo stringa corrisponde al criterio di ricerca. (Ereditato da SearchIterator) |
| Following(Int32) |
Restituisce il primo indice uguale o maggiore di quello in |
| GetElementComparisonType() |
|
| GetHashCode() |
Restituisce un valore di codice hash per l'oggetto . (Ereditato da Object) |
| HandleNext(Int32) |
Metodo astratto che esegue l'override delle sottoclassi per fornire il meccanismo per trovare la corrispondenza successiva nel testo di destinazione. (Ereditato da SearchIterator) |
| HandlePrevious(Int32) |
Metodo astratto che esegue l'override delle sottoclassi per fornire il meccanismo per trovare la corrispondenza precedente nel testo di destinazione. (Ereditato da SearchIterator) |
| JavaFinalize() |
Chiamato dal Garbage Collector su un oggetto quando Garbage Collection determina che non sono presenti altri riferimenti all'oggetto . (Ereditato da Object) |
| Last() |
Restituisce l'ultimo indice nel testo di destinazione in corrispondenza del criterio di ricerca. (Ereditato da SearchIterator) |
| Next() |
Restituisce l'indice del punto successivo in cui il testo corrisponde al criterio di ricerca, a partire dalla posizione corrente L'iteratore viene regolato in modo che il relativo indice corrente (come restituito da |
| Notify() |
Riattiva un singolo thread in attesa del monitor dell'oggetto. (Ereditato da Object) |
| NotifyAll() |
Riattiva tutti i thread in attesa del monitor dell'oggetto. (Ereditato da Object) |
| Preceding(Int32) |
Restituisce il primo indice minore di |
| Previous() |
Restituisce l'indice del punto precedente in cui il testo stringa corrisponde al criterio di ricerca, a partire dalla posizione corrente. (Ereditato da SearchIterator) |
| Reset() |
Reimposta l'iterazione. (Ereditato da SearchIterator) |
| SetElementComparisonType(SearchIterator+ElementComparisonType) |
|
| SetHandle(IntPtr, JniHandleOwnership) |
Imposta la proprietà Handle. (Ereditato da Object) |
| SetIndex(Int32) |
Imposta la posizione nel testo di destinazione in corrispondenza della quale verrà avviata la ricerca successiva. (Ereditato da SearchIterator) |
| SetMatchLength(Int32) |
Imposta la lunghezza della corrispondenza più recente nel testo di destinazione. (Ereditato da SearchIterator) |
| ToArray<T>() |
|
| ToString() |
Restituisce una rappresentazione di stringa dell'oggetto . (Ereditato da Object) |
| UnregisterFromRuntime() |
|
| Wait() |
Fa sì che il thread corrente attenda finché non viene risvegliato, in genere ricevendo <>una notifica</em> o <em>interrotto</em>. (Ereditato da Object) |
| Wait(Int64, Int32) |
Fa sì che il thread corrente attenda finché non viene risvegliato, in genere ricevendo<> una notifica</em> o <em>interrotto</em> o fino a quando non è trascorsa una determinata quantità di tempo reale. (Ereditato da Object) |
| Wait(Int64) |
Fa sì che il thread corrente attenda finché non viene risvegliato, in genere ricevendo<> una notifica</em> o <em>interrotto</em> o fino a quando non è trascorsa una determinata quantità di tempo reale. (Ereditato da Object) |
Implementazioni dell'interfaccia esplicita
| Nome | Descrizione |
|---|---|
| IJavaPeerable.Disposed() |
|
| IJavaPeerable.DisposeUnlessReferenced() |
|
| IJavaPeerable.Finalized() |
|
| IJavaPeerable.JniManagedPeerState |
|
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
|
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
|
| IJavaPeerable.SetPeerReference(JniObjectReference) |
|
Metodi di estensione
| Nome | Descrizione |
|---|---|
| GetJniTypeName(IJavaPeerable) |
Ottiene il nome JNI del tipo dell'istanza |
| JavaAs<TResult>(IJavaPeerable) |
Provare a digitare |
| JavaCast<TResult>(IJavaObject) |
Esegue una conversione del tipo di tipo controllato dal runtime Android. |
| JavaCast<TResult>(IJavaObject) |
|
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Provare a digitare |