Contenuto principale

contains

Determinare se il pattern è presente nelle stringhe

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.

esempio

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

esempio

Esempi

comprimi tutto

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"

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.

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"

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"

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

comprimi tutto

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

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

Suggerimenti

  • Una stringa senza caratteri ("") o un vettore di caratteri senza caratteri ('') è una sottostringa di ogni stringa. Pertanto, contains trova sempre tali sottostringhe all'interno di qualsiasi testo di input. Per maggiori informazioni, vedere Test for Empty Strings and Missing Values.

Funzionalità estese

espandi tutto

Cronologia versioni

Introdotto in R2016b