contains

Ermitteln, ob ein Muster in Zeichenfolgen ausgedrückt ist

Syntax

TF = contains(str,pat)

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

Beschreibung

TF = contains(str,pat) gibt 1 (true) aus, wenn str das angegebene Muster umfasst und gibt andernfalls 0 (false) aus.

Wenn pat ein Array mit mehreren Mustern ist, gibt contains 1 zurück, wenn Elemente von pat in str gefunden werden.

Wenn es sich bei str um ein String Array oder Zellenarray handelt, ist TF ein logisches Array mit derselben Größe wie str.

TF = contains(str,pat,'IgnoreCase',true) ignoriert Groß- und Kleinschreibung bei der Ermittlung, ob str pat enthält.

Beispiele

Suchen von Text

Erstellen Sie ein String Array aus Namen, in dem einige Namen Paul enthalten.

Sie können Zeichenfolgen mit doppelten Anführungszeichen erstellen.

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

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

Geben Sie ein logisches Array zurück, in dem die Position jedes Elements gleich 1 der Position einer Zeichenfolge in str, die Paul enthält, entspricht.

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

TF = 1×3 logical array

   0   1   1

Zeigen Sie die Zeichenfolgen, die Paul enthalten, an. Indizieren Sie mithilfe von TF wieder in str.

str(TF)

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

Suchen mithilfe von Mustern

Ab R2020b

Erstellen Sie ein String Array mit Adressen.

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."

Um Adressen zu finden, die Zahlen enthalten, erstellen Sie ein Muster, das mithilfe der digitsPattern-Funktion eine beliebige Anzahl von Ziffern abgleicht.

pat = digitsPattern

pat = pattern
  Matching:

    digitsPattern

Geben Sie ein logisches Array aus, das angibt, welche Zeichenfolgen Ziffern enthalten. Zeigen Sie die übereinstimmenden Zeichenfolgen an.

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."

Suchen Sie Zeichenfolgen, die eine Sequenz von Ziffern gefolgt von einem Buchstaben enthalten. Sie können einfache Muster kombinieren, um komplexere Muster zu erstellen.

pat = digitsPattern + lettersPattern(1)

pat = pattern
  Matching:

    digitsPattern + lettersPattern(1)

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

ans = 
"221B Baker St."

Eine Liste der Funktionen, die Musterobjekte erstellen, finden Sie unter pattern.

Abgleichen von beliebigem Text in einer Liste

Erstellen Sie ein String Array aus Namen, in dem einige Namen entweder Ann oder Paul enthalten.

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

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

Suchen Sie die Elemente von str, die entweder Ann oder Paul enthalten.

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

TF = 1×3 logical array

   1   0   1

Indizieren Sie mithilfe von TF wieder in str.

str(TF)

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

Ignorieren von Groß-/Kleinschreibung

Erstellen Sie ein String Array, das Namen enthält. Ermitteln Sie, welche Namen anne enthalten, wobei Groß- und Kleinschreibung ignoriert wird.

Sie können Zeichenfolgen mit doppelten Anführungszeichen erstellen.

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

Zeigen Sie die Zeichenfolgen, die anne enthalten, an. Indizieren Sie mithilfe von TF wieder in str.

str(TF)

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

Ermitteln, ob ein Zeichenvektor Unterzeichenfolgen enthält

Erstellen Sie einen Zeichenvektor, der eine Liste mit Lebensmitteln enthält. Ermitteln Sie, ob die Namen verschiedener Lebensmittel im Zeichenvektor enthalten sind.

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

TF = logical
   1

TF = contains(chr,'pineapples')

TF = logical
   0

Eingabeargumente

str — Eingabetext

String Array | Zeichenvektor | Zellenarray mit Zeichenvektoren

Eingabetext, angegeben als String Array, Zeichenvektor oder Zellenarray aus Zeichenvektoren.

pat — Suchmuster

String Array | Zeichenvektor | Zellenarray mit Zeichenvektoren | pattern-Array (ab R2020b)

Suchmuster, angegeben als eine der folgenden Optionen:

• String Array

• Zeichenvektor

• Zellenarray aus Zeichenvektoren

• pattern-Array (ab R2020b)

Erweiterte Fähigkeiten

Tall Arrays

Rechnen mit Arrays, die mehr Zeilen haben, als in den Speicher passen.

Die Funktion contains bietet vollständige Unterstützung für Tall-Arrays. Weitere Informationen finden Sie unter Tall-Arrays.

C/C++ Codegenerierung

Generieren Sie C und C++ Code mit MATLAB® Coder™.

Hinweise zur Verwendung und Einschränkungen:

• str und pat müssen ein Zeichenfolgenskalar, ein Zeichenvektor oder ein Zellenarray mit höchstens einem Zeichenvektor sein.

Thread-Based Environment

Führen Sie mithilfe von MATLAB® backgroundPool den Code im Hintergrund aus oder machen Sie den Code mit der Parallel Computing Toolbox™ ThreadPool schneller.

Diese Funktion bietet vollständige Unterstützung für thread-basierte Umgebungen. Weitere Informationen finden Sie unter Run MATLAB Functions in Thread-Based Environment.

Verteilte Arrays

Partitionieren von großen Arrays über den kombinierten Speicher Ihres Clusters mit Parallel Computing Toolbox™.

Diese Funktion bietet vollständige Unterstützung für verteilte Arrays. Weitere Informationen finden Sie unter Run MATLAB Functions with Distributed Arrays (Parallel Computing Toolbox).

Versionsverlauf

Eingeführt in R2016b

Siehe auch

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

Themen

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