Verifichi se un testo contiene una sottostringa

Restituisce un valore booleano e la posizione, calcolata a partire da zero, della prima corrispondenza, oppure -1 se non ve ne sono. Lei può mantenere la distinzione esatta tra maiuscole e minuscole oppure ignorarla. Il risultato è deterministico, facile da verificare e utile quando un flusso richiede una condizione di ricerca rapida senza espressioni regolari o corrispondenze approssimative.

Controlli una sottostringa con un risultato inequivocabile

Inserisca il valore completo in text e la sequenza da individuare in substring. La risposta comprende contains, che vale true quando esiste una corrispondenza, e position, che indica dove comincia la prima occorrenza. Le posizioni partono da zero: una sottostringa all’inizio restituisce quindi la posizione 0. Se non viene trovata, il risultato è false e la posizione è -1, così l’assenza resta distinta da una corrispondenza iniziale. Questa coppia è comoda sia per chi legge sia per il software che applica una condizione. L’operazione cerca una sottostringa letterale e contigua. Spazi, punteggiatura e caratteri ripetuti sono trattati come testo normale, non come schemi, quindi non occorre eseguire l’escape dei simboli delle espressioni regolari. Se la stessa sottostringa compare più volte, viene indicata soltanto la prima posizione. Il comportamento è particolarmente utile nelle convalide in cui conta sapere se compare un marcatore previsto e dove potrebbe iniziare un’analisi successiva. Una sottostringa vuota viene rifiutata perché ogni stringa tecnicamente la contiene e il risultato sarebbe sorprendente e poco utile.

Scelga se distinguere maiuscole e minuscole

L’opzione case_sensitive è true per impostazione predefinita. In questa modalità, maiuscole e minuscole devono coincidere esattamente: cercare “Ready” non trova “ready”. La corrispondenza esatta è adatta a identificatori, marcatori di protocollo, codici prodotto e contenuti in cui l’uso delle maiuscole ha significato. Imposti false quando desidera un controllo testuale pratico che consideri equivalenti tali varianti, ad esempio per trovare una parola di stato nelle note inserite dagli utenti o verificare che un titolo contenga una frase. La modalità senza distinzione normalizza coerentemente il testo sorgente e la sottostringa prima di localizzare la prima occorrenza, mentre la posizione restituita continua a riferirsi al testo originale. La capacità non elimina gli spazi alle estremità e non modifica la punteggiatura, che rimangono quindi significativi. Non esegue neppure equivalenza degli accenti, stemming, traslitterazione, confronto approssimativo o rilevamento di parole intere. Per esempio, “cat” può corrispondere alle prime tre lettere di “catalog”. Regole così circoscritte rendono ogni risultato ripetibile ed evitano assunzioni linguistiche silenziose.

Usi la posizione in sicurezza nei flussi di convalida

Un flusso tipico invia un valore candidato, controlla contains e sceglie un ramo senza dover interpretare il campo numerico. Quando esiste una corrispondenza, position può supportare diagnosi, anteprime o una fase di analisi successiva. Un controllo d’importazione, per esempio, può confermare che un’intestazione include un token obbligatorio e registrare dove inizia; un test può verificare che un testo generato contenga una frase approvata; uno strumento di assistenza può rilevare un marcatore noto in una riga di log incollata. Consideri sempre la posizione restituita come un indice di stringa JavaScript, misurato in unità di codice UTF-16. Nel normale testo latino coincide con il conteggio consueto dei caratteri, ma alcune emoji e simboli Unicode meno comuni occupano due unità. L’indice nativo della piattaforma viene restituito deliberatamente affinché browser e API producano lo stesso risultato e Lei possa usarlo direttamente con i metodi di suddivisione JavaScript. Questa è una ricerca letterale, non un sistema di sanitizzazione o classificazione. Convalidi separatamente la struttura dei formati sensibili e utilizzi un parser dedicato quando contano limiti, escape o corrispondenze multiple.