extract

Extraer subcadenas de cadenas

Sintaxis

newStr = extract(str,pat)

newStr = extract(str,pos)

Descripción

newStr = extract(str,pat) devuelve cualquier subcadena de str que coincida con el patrón especificado por pat.

Si str es un arreglo de cadenas o un arreglo de celdas de vectores de caracteres, la función extrae subcadenas de cada elemento de str. Si pat es un arreglo, la función coincide con múltiples patrones.

newStr = extract(str,pos) devuelve el carácter de str en la posición especificada por pos.

Ejemplos

Extraer códigos postales de direcciones

Cree un arreglo de cadenas que contenga direcciones. Cada dirección termina con un código postal de Estados Unidos.

str = ["73 Beacon St., Boston, MA, 02116";
       "1640 Riverside Dr., Hill Valley, CA, 92530";
       "138 Main St., Cambridge, MA, 02138"]

str = 3×1 string
    "73 Beacon St., Boston, MA, 02116"
    "1640 Riverside Dr., Hill Valley, CA, 92530"
    "138 Main St., Cambridge, MA, 02138"

Cree un patrón que coincida con cualquier secuencia de dígitos.

pat = digitsPattern

pat = pattern
  Matching:

    digitsPattern

Utilícelo para extraer todas las secuencias de dígitos de las direcciones.

newStr = extract(str,pat)

newStr = 3×2 string
    "73"      "02116"
    "1640"    "92530"
    "138"     "02138"

El patrón digitsPattern coincide con los números de las calles, los números de piso y los códigos postales. Para que solo coincida con los códigos postales, cree un patrón que coincida con una secuencia de dígitos al final de una dirección.

pat = digitsPattern + textBoundary

pat = pattern
  Matching:

    digitsPattern + textBoundary

Extraiga los códigos postales.

newStr = extract(str,pat)

newStr = 3×1 string
    "02116"
    "92530"
    "02138"

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

Extraer un carácter en una posición numérica

Cree una cadena.

str = "All's well that ends well"

str = 
"All's well that ends well"

Extraiga el primer carácter de la cadena.

extract(str,1)

ans = 
"A"

Extraiga el último carácter.

extract(str,strlength(str))

ans = 
"l"

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

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

pos — Posición

arreglo numérico

Posición, especificada como arreglo numérico.

Si str es un arreglo de cadenas o un arreglo de celdas de vectores de caracteres, entonces pos puede ser un escalar numérico o un arreglo numérico del mismo tamaño que str.

Argumentos de salida

newStr — Texto de salida

arreglo de cadenas | arreglo de celdas de vectores de caracteres

Texto de salida, especificado como arreglo de cadenas o un arreglo de celdas de vectores de caracteres.

Si str es un arreglo de cadenas, newStr también es un arreglo de cadenas. De lo contrario, newStr es un arreglo de celdas de vectores de caracteres.

Capacidades ampliadas

Arreglos altos

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

La función extract es compatible con arreglos altos con las siguientes notas y limitaciones de uso:

• Si pat es un arreglo de objetos de patrones, el tamaño de la primera dimensión del arreglo debe ser 1.

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

Para la generación de código, los argumentos de entrada deben ser un:

• Vector de caracteres o arreglo de celdas de vectores de caracteres para el texto de entrada str.

• Vector de caracteres o arreglo de celdas de vectores de caracteres para el patrón de búsqueda pat

Arreglos distribuidos

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

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 R2020b

R2025a: Compatibilidad con la generación de código

Puede generar código C/C++ para esta función.

Consulte también

split | join | erase | extractAfter | extractBefore | extractBetween | insertAfter | insertBefore | replace | strlength | count | pattern | digitsPattern | lettersPattern | textBoundary

Temas

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