contains

Determinare se il pattern è presente nelle stringhe

Sintassi

TF = contains(str,pat)

TF = contains(str,pat,'IgnoreCase',true)

Descrizione

TF = contains(str,pat) restituisce 1 (true) se str contiene il pattern specificato, altrimenti restituisce 0 (false).

Se pat è un array che contiene più modelli, contains restituisce 1 se trova un qualsiasi elemento di pat in str.

Se str è un array di stringhe o un array di celle, TF è un array logico della stessa grandezza di str.

TF = contains(str,pat,'IgnoreCase',true) ignora le maiuscole/minuscole quando determina se str contiene pat.

Esempi

Individuazione testo

Creare un array di stringhe di nomi, in cui alcuni nomi contengono Paul.

È possibile creare le stringhe utilizzando le virgolette doppie.

str = ["Mary Ann Jones","Paul Jay Burns","John Paul Smith"]

str = 1×3 string
    "Mary Ann Jones"    "Paul Jay Burns"    "John Paul Smith"

Restituisce un array logico in cui la posizione di ciascun elemento uguale a 1 corrisponde alla posizione di una stringa in str che contiene Paul.

pat = "Paul";
TF = contains(str,pat)

TF = 1×3 logical array

   0   1   1

Visualizzare le stringhe che contengono Paul. Riconvertire l'indice in str utilizzando TF.

str(TF)

ans = 1×2 string
    "Paul Jay Burns"    "John Paul Smith"

Ricerca utilizzando i pattern

Dalla release R2020b

Creare un array di stringhe che contiene indirizzi.

str = ["221B Baker St.","Tour Eiffel Champ de Mars","4059 Mt Lee Dr."]

str = 1×3 string
    "221B Baker St."    "Tour Eiffel Champ de Mars"    "4059 Mt Lee Dr."

Per trovare gli indirizzi che contengono numeri, creare un pattern che corrisponda a un numero arbitrario di cifre utilizzando la funzione digitsPattern.

pat = digitsPattern

pat = pattern
  Matching:

    digitsPattern

Restituisce un array logico che indica quali stringhe contengono cifre. Visualizzare le stringhe corrispondenti.

TF = contains(str,pat)

TF = 1×3 logical array

   1   0   1

str(TF)

ans = 1×2 string
    "221B Baker St."    "4059 Mt Lee Dr."

Cercare le stringhe che presentano una sequenza di cifre seguite da una lettera. È possibile costruire pattern più complessi combinando pattern semplici.

pat = digitsPattern + lettersPattern(1)

pat = pattern
  Matching:

    digitsPattern + lettersPattern(1)

TF = contains(str,pat);
str(TF)

ans = 
"221B Baker St."

Per un elenco delle funzioni che creano oggetti pattern, vedere pattern.

Corrispondenza con qualsiasi testo in elenco

Creare un array di stringhe di nomi, in cui alcuni nomi contengono Ann o Paul.

str = ["Mary Ann Jones","Christopher Matthew Burns","John Paul Smith"]

str = 1×3 string
    "Mary Ann Jones"    "Christopher Matthew Burns"    "John Paul Smith"

Trovare gli elementi di str che contengono Ann o Paul.

pat = ["Ann","Paul"];
TF = contains(str,pat)

TF = 1×3 logical array

   1   0   1

Riconvertire l'indice in str utilizzando TF.

str(TF)

ans = 1×2 string
    "Mary Ann Jones"    "John Paul Smith"

Indifferenza alle maiuscole/minuscole

Creare un array di stringhe che contiene nomi. Determinare quali nomi contengono anne, ignorando le maiuscole/minuscole.

È possibile creare le stringhe utilizzando le virgolette doppie.

str = ["Anne","Elizabeth","Marianne","Tracy"]

str = 1×4 string
    "Anne"    "Elizabeth"    "Marianne"    "Tracy"

pat = "anne";
TF = contains(str,pat,'IgnoreCase',true)

TF = 1×4 logical array

   1   0   1   0

Visualizzare le stringhe che contengono anne. Riconvertire l'indice in str utilizzando TF.

str(TF)

ans = 1×2 string
    "Anne"    "Marianne"

Determinazione della presenza di sottostringhe nel vettore di caratteri

Creare un vettore di caratteri che contenga un elenco di alimenti. Determinare se i nomi dei diversi alimenti sono presenti nel vettore di caratteri.

chr = 'peppers, onions, and mushrooms';
TF = contains(chr,'onion')

TF = logical
   1

TF = contains(chr,'pineapples')

TF = logical
   0

Argomenti di input

str — Testo di input

array di stringhe | vettore di caratteri | array di celle di vettori di caratteri

Testo di input, specificato come array di stringhe, vettore di caratteri o array di celle di vettori di caratteri.

pat — Pattern di ricerca

array di stringhe | vettore di caratteri | array di celle di vettori di caratteri | Array di pattern (dalla release R2020b)

Pattern di ricerca, specificato in uno dei seguenti modi:

• Array di stringhe

• Vettore di caratteri

• Array di celle di vettori di caratteri

• Array di pattern (dalla release R2020b)

Funzionalità estese

Tall array

Esegui calcoli con array che hanno più righe di quelle allocabili in memoria.

La funzione contains supporta completamente i tall array. Per maggiori informazioni, vedere Tall Array.

Generazione di codice C/C++

Genera codice C e C++ con MATLAB® Coder™.

Note su utilizzo e limitazioni:

• str e pat devono essere uno scalare di stringa, un vettore di caratteri o un array di celle contenente non più di un vettore di caratteri.

Ambiente basato su thread

Esegui il codice in background usando MATLAB® backgroundPool oppure accelera il codice con Parallel Computing Toolbox™ ThreadPool.

Questa funzione supporta completamente gli ambienti basati su thread. Per maggiori informazioni, vedere Run MATLAB Functions in Thread-Based Environment.

Array distribuiti

Partiziona array di grandi dimensioni nella memoria combinata del cluster con Parallel Computing Toolbox™.

Questa funzione supporta completamente gli array distribuiti. Per maggiori informazioni, vedere Run MATLAB Functions with Distributed Arrays (Parallel Computing Toolbox).

Cronologia versioni

Introdotto in R2016b

Vedi anche

count | endsWith | extract | matches | replace | startsWith | split | pattern | digitsPattern | lettersPattern

Argomenti

• Create String Arrays
• Compare Text
• Search and Replace Text
• Build Pattern Expressions
• Test for Empty Strings and Missing Values