La traducción de esta página aún no se ha actualizado a la versión más reciente. Haga clic aquí para ver la última versión en inglés.

contains

Determinar si un patrón está en cadenas

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.

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

Ejemplos

Encontrar un texto

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"

Buscar utilizando patrones

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.

Encontrar una coincidencia de cualquier texto en una lista

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"

Ignorar las mayúsculas y las minúsculas

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"

Determinar si un vector de caracteres contiene subcadenas

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

str — Texto de entrada

arreglo de cadenas | vector de caracteres | arreglo de celdas de vectores de caracteres

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

pat — Patrón de búsqueda

arreglo de cadenas | vector de caracteres | arreglo de celdas de vectores de caracteres | Arreglo de pattern (desde la versión R2020b)

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

Arreglos altos

Realice cálculos con arreglos que tienen más filas de las que caben en la memoria.

La función contains es totalmente compatible con los arreglos altos. Para obtener más información, consulte Arreglos altos.

Generación de código C/C++

Genere código C y C++ mediante MATLAB® Coder™.

Notas y limitaciones de uso:

• str y pat deben ser un escalar de cadena, un vector de caracteres o un arreglo de celdas que no contengan más de un vector de caracteres.

Entorno basado en subprocesos

Ejecute código en segundo plano con MATLAB® backgroundPool o acelere código con Parallel Computing Toolbox™ ThreadPool.

Esta función es totalmente compatible con entornos basados en subprocesos. Para obtener más información, consulte Ejecutar funciones de MATLAB en entornos basados en subprocesos.

Arreglos distribuidos

Realice particiones de arreglos grandes por toda la memoria combinada de su cluster mediante Parallel Computing Toolbox™.

Esta función es totalmente compatible con los arreglos distribuidos. Para obtener más información, consulte Run MATLAB Functions with Distributed Arrays (Parallel Computing Toolbox).

Historial de versiones

Introducido en R2016b

Consulte también

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

Temas

• Crear arreglos de cadenas
• Comparar texto
• Buscar y reemplazar texto
• Build Pattern Expressions
• Comprobar cadenas vacías y valores faltantes