contains

Determinar si un patrón está en cadenas

contraer todo en la página

Sintaxis

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

Descripción

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.

ejemplo

Ejemplos

contraer todo

Abrir script en vivo

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 = 1×3 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 = 1×3 logical array

   0   1   1

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

str(TF)
ans = 1×2 string
    "Paul Jay Burns"    "John Paul Smith"
Abrir script en vivo

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 = 1×3 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 = 1×3 logical array

   1   0   1


str(TF)
ans = 1×2 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.

Abrir script en vivo

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 = 1×3 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 = 1×3 logical array

   1   0   1

Vuelva a indexar en str utilizando TF.

str(TF)
ans = 1×2 string
    "Mary Ann Jones"    "John Paul Smith"
Abrir script en vivo

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 = 1×4 string
    "Anne"    "Elizabeth"    "Marianne"    "Tracy"


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

   1   0   1   0

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

str(TF)
ans = 1×2 string
    "Anne"    "Marianne"
Abrir script en vivo

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

Sugerencias

  • Una cadena sin caracteres ("") o un vector de caracteres sin caracteres ('') es una subcadena de cada cadena. Por lo tanto, contains siempre encuentra subcadenas de este tipo dentro de cualquier texto de entrada. Para obtener más información, consulte Comprobar cadenas vacías y valores faltantes.

Capacidades ampliadas

expandir todo

Historial de versiones

Introducido en R2016b

Consulte también

| | | | | | | | |

Temas