Contenuto principale

contains

R2026b

Determinare se le stringhe o i nomi delle categorie contengono pattern

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, un array di celle o un array categorico, TF è un array logico delle stesse dimensioni 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"

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

Da R2026b

Caricare i dati sulle interruzioni della fornitura elettrica negli Stati Uniti come tabella. Convertire la variabile Cause in un array categorico.

T = readtable("outages.csv");
T.Cause = categorical(T.Cause);

Determinare se i nomi delle categorie di Cause contengono "storm". La funzione contains restituisce un array logico che indica quali elementi dell'array categorico Cause hanno nomi delle categorie che contengono "storm".

TF = contains(T.Cause,"storm",IgnoreCase=true)
TF = 1468×1 logical array

   1
   1
   1
   0
   1
   0
   0
   0
   0
   0
   0
   0
   1
   1
   1
      ⋮

Visualizzare solo le righe della tabella in cui la causa contiene "storm".

T(TF,:)
ans = 684×6 table
       Region           OutageTime        Loss     Customers     RestorationTime        Cause    
    _____________    ________________    ______    __________    ________________    ____________

    {'SouthWest'}    2002-02-01 12:18    458.98    1.8202e+06    2002-02-07 16:50    winter storm
    {'SouthEast'}    2003-01-23 00:49    530.14    2.1204e+05                 NaT    winter storm
    {'SouthEast'}    2003-02-07 21:15     289.4    1.4294e+05    2003-02-17 08:14    winter storm
    {'MidWest'  }    2002-03-16 06:18    186.44    2.1275e+05    2002-03-18 23:23    severe storm
    {'SouthEast'}    2002-09-01 18:22    95.917         36759    2002-09-01 19:12    severe storm
    {'SouthEast'}    2003-09-27 07:32       NaN    3.5517e+05    2003-10-04 07:02    severe storm
    {'West'     }    2003-11-12 06:12    254.09    9.2429e+05    2003-11-17 02:04    winter storm
    {'NorthEast'}    2004-11-13 10:42       NaN    1.4227e+05    2004-11-19 02:31    winter storm
    {'SouthEast'}    2004-12-06 23:18       NaN         37136    2004-12-14 03:21    winter storm
    {'SouthEast'}    2002-12-12 18:08    46.918    1.0698e+05    2002-12-14 18:43    winter storm
    {'West'     }    2004-12-21 18:50    112.05     7.985e+05    2004-12-29 03:46    winter storm
    {'West'     }    2002-12-16 13:43    70.752    4.8193e+05    2002-12-19 09:38    winter storm
    {'NorthEast'}    2004-12-26 22:18    255.45    1.0444e+05    2004-12-27 14:11    winter storm
    {'NorthEast'}    2003-12-17 15:11       NaN         66692    2003-12-19 07:22    winter storm
    {'SouthEast'}    2005-03-08 16:37    1339.2    4.3003e+05    2005-03-10 20:42    winter storm
    {'MidWest'  }    2002-03-26 01:59    388.04    5.6422e+05    2002-03-28 19:55    winter storm
      ⋮

.

Argomenti di input

comprimi tutto

Array di input, specificato come array di stringhe, vettore di caratteri, array di celle di vettori di caratteri o array categorico (da R2026b).

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

espandi tutto