contains

Déterminer si un motif figure dans des chaînes de caractères

Syntaxe

TF = contains(str,pat)

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

Description

TF = contains(str,pat) renvoie 1 (true) si str contient le motif spécifié et 0 (false) dans le cas contraire.

Si pat est un tableau contenant plusieurs motifs, contains renvoie 1 si l’un des éléments de pat figure dans str.

Si str est un tableau de chaînes de caractères ou un cell array, TF est un tableau logique de même taille que str.

TF = contains(str,pat,'IgnoreCase',true) ignore la casse pour déterminer si str contient pat.

Exemples

Rechercher du texte

Créez un tableau de chaînes de caractères avec des noms, dont certains contiennent Paul.

Vous pouvez créer des chaînes de caractères avec des guillemets anglais.

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

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

Renvoyez un tableau logique où la position de chaque élément égal à 1 correspond à la position d’une chaîne de caractères de str contenant Paul.

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

TF = 1×3 logical array

   0   1   1

Affichez les chaînes de caractères qui contiennent Paul. Réindexez str avec TF.

str(TF)

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

Effectuer une recherche à l’aide de motifs

Depuis la version R2020b

Créez un tableau de chaînes de caractères contenant des adresses.

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

Pour rechercher les adresses qui contiennent des nombres, créez un motif correspondant à un nombre arbitraire de chiffres avec la fonction digitsPattern.

pat = digitsPattern

pat = pattern
  Matching:

    digitsPattern

Renvoyez un tableau logique indiquant quelles chaînes de caractères contiennent des chiffres. Affichez les chaînes de caractères correspondantes.

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

Recherchez les chaînes de caractères contenant une série de chiffres suivie d’une seule lettre. Vous pouvez créer des motifs plus complexes en combinant des motifs simples.

pat = digitsPattern + lettersPattern(1)

pat = pattern
  Matching:

    digitsPattern + lettersPattern(1)

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

ans = 
"221B Baker St."

Pour une liste des fonctions qui créent des objets pattern, consultez pattern.

Mettre en correspondance n’importe quel texte d’une liste

Créez un tableau de chaînes de caractères avec des noms dont certains contiennent soit Ann, soit Paul.

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

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

Recherchez les éléments de str qui contiennent soit Ann, soit Paul.

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

TF = 1×3 logical array

   1   0   1

Réindexez str avec TF.

str(TF)

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

Ignorer la casse

Créez un tableau de chaînes de caractères contenant des noms. Déterminez quels noms contiennent anne en ignorant la casse.

Vous pouvez créer des chaînes de caractères avec des guillemets anglais.

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

Affichez les chaînes de caractères qui contiennent anne. Réindexez str avec TF.

str(TF)

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

Déterminer si un vecteur de caractères contient des sous-chaînes de caractères

Créez un vecteur de caractères contenant une liste d’aliments. Déterminez si les noms de différents aliments figurent dans le vecteur de caractères.

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

TF = logical
   1

TF = contains(chr,'pineapples')

TF = logical
   0

Arguments d'entrée

str — Texte en entrée

Tableau de chaînes de caractères | vecteur de caractères | cell array de vecteurs de caractères

Texte en entrée, spécifié sous forme de tableau de chaînes de caractères, de vecteur de caractères ou de cell array de vecteurs de caractères.

pat — Motif à rechercher

Tableau de chaînes de caractères | vecteur de caractères | cell array de vecteurs de caractères | tableau pattern (depuis la version R2020b)

Motif à rechercher, spécifié sous une des formes suivantes :

• Tableau de chaînes de caractères

• Vecteur de caractères

• Cell array de vecteurs de caractères

• Tableau pattern (depuis la version R2020b)

Capacités étendues

Tall arrays

Calculer avec des arrays possédant plus de rangées que la mémoire ne peut en contenir.

La fonction contains supporte entièrement les tall arrays. Pour plus d’informations, consultez Tall array.

Génération de code C/C++

Générez du code C et C++ avec MATLAB® Coder™.

Notes d’usage et limitations :

• str et pat doivent être un string scalar, un vecteur de caractères ou un cell array ne contenant pas plus d’un vecteur de caractères.

Environnement basé sur les threads

Exécutez du code en arrière-plan avec MATLAB® backgroundPool ou accélérez le code avec Parallel Computing Toolbox™ ThreadPool.

Cette fonction supporte entièrement les environnements basés sur des threads. Pour plus d’informations, consultez Run MATLAB Functions in Thread-Based Environment.

Distributed arrays

Divisez les tableaux volumineux dans la mémoire combinée de votre cluster avec Parallel Computing Toolbox™.

Cette fonction supporte entièrement les distributed arrays. Pour plus d’informations, consultez Exécuter les fonctions MATLAB avec des tableaux distribués (Parallel Computing Toolbox).

Historique des versions

Introduit dans R2016b

Voir aussi

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

Rubriques

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