Main Content

contains

Determinar si un patrón está en cadenas

Descripción

ejemplo

TF = contains(str,pat) devuelve 1 (true) si str contiene el patrón especificado y devuelve 0 (false) en caso contrario.

Si pat es un arreglo que contiene múltiples patrones, contains devuelve 1 si encuentra cualquier elemento de pat en str.

Si str es un arreglo de cadenas o de celdas, TF es un arreglo lógico que tiene el mismo tamaño que str.

ejemplo

TF = contains(str,pat,'IgnoreCase',true) ignora las mayúsculas y las minúsculas cuando se determina si str contiene pat.

Ejemplos

contraer todo

Cree un arreglo de cadenas de nombres en el que algunos nombres contengan Paul.

Puede crear cadenas utilizando comillas dobles.

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

Devuelva un arreglo lógico en el que la posición de cada elemento igual a 1 se corresponda con la posición de una cadena en str que contenga Paul.

pat = "Paul";
TF = contains(str,pat)
TF = 1x3 logical array

   0   1   1

Visualice las cadenas que contengan Paul. Vuelva a indexar en str utilizando TF.

str(TF)
ans = 1x2 string
    "Paul Jay Burns"    "John Paul Smith"

Desde la versión R2020b

Cree un arreglo de cadenas que contenga direcciones.

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

Para encontrar direcciones que contengan números, cree un patrón que coincida con un número arbitrario de dígitos utilizando la función digitsPattern.

pat = digitsPattern
pat = pattern
  Matching:

    digitsPattern

Devuelva un arreglo lógico que indique qué cadenas contienen dígitos. Visualice las cadenas que coinciden.

TF = contains(str,pat)
TF = 1x3 logical array

   1   0   1

str(TF)
ans = 1x2 string
    "221B Baker St."    "4059 Mt Lee Dr."

Busque cadenas que tengan una secuencia de dígitos seguida de una letra. Puede crear patrones más complejos combinando patrones sencillos.

pat = digitsPattern + lettersPattern(1)
pat = pattern
  Matching:

    digitsPattern + lettersPattern(1)

TF = contains(str,pat);
str(TF)
ans = 
"221B Baker St."

Para ver una lista de las funciones que crean objetos de patrones, consulte pattern.

Cree un arreglo de cadenas de nombres en el que algunos nombres contengan Ann o Paul.

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

Encuentre los elementos de str que contengan Ann o Paul.

pat = ["Ann","Paul"];
TF = contains(str,pat)
TF = 1x3 logical array

   1   0   1

Vuelva a indexar en str utilizando TF.

str(TF)
ans = 1x2 string
    "Mary Ann Jones"    "John Paul Smith"

Cree un arreglo de cadenas que contenga nombres. Determine qué nombres contienen anne e ignore las mayúsculas y las minúsculas.

Puede crear cadenas utilizando comillas dobles.

str = ["Anne","Elizabeth","Marianne","Tracy"]
str = 1x4 string
    "Anne"    "Elizabeth"    "Marianne"    "Tracy"

pat = "anne";
TF = contains(str,pat,'IgnoreCase',true)
TF = 1x4 logical array

   1   0   1   0

Visualice las cadenas que contengan anne. Vuelva a indexar en str utilizando TF.

str(TF)
ans = 1x2 string
    "Anne"    "Marianne"

Cree un vector de caracteres que contenga una lista de alimentos. Determine si los nombres de los distintos alimentos se incluyen en el vector de caracteres.

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

TF = contains(chr,'pineapples')
TF = logical
   0

Argumentos de entrada

contraer todo

Texto de entrada, especificado como arreglo de caracteres, vector de caracteres o arreglo de celdas de vectores de caracteres.

Patrón de búsqueda, especificado como una de las siguientes opciones:

  • Arreglo de cadenas

  • Vector de caracteres

  • Arreglo de celdas de vectores de caracteres

  • Arreglo de pattern (desde la versión R2020b)

Capacidades ampliadas

Historial de versiones

Introducido en R2016b