strfind

Encontrar cadenas dentro de otras cadenas

Sintaxis

k = strfind(str,pat)

k = strfind(str,pat,'ForceCellOutput',cellOutput)

Descripción

k = strfind(str,pat) busca en str instancias de pat. La salida, k, indica el índice de inicio de cada instancia de pat en str. Si no se encuentra pat, strfind devuelve un arreglo vacío []. La función strfind ejecuta una búsqueda que distingue entre mayúsculas y minúsculas.

• Si str es un vector de caracteres o un escalar de cadena, strfind devuelve un vector de tipo double.

• Si str es un arreglo de celdas de vectores de caracteres o un arreglo de cadenas, strfind devuelve un arreglo de celdas de vectores de tipo double.

k = strfind(str,pat,'ForceCellOutput',cellOutput) fuerza a strfind a devolver k como arreglo de celdas cuando cellOutput es verdadero y aunque str sea un vector de caracteres.

Ejemplos

Encontrar subcadenas en un vector de caracteres

Busque los índices de inicio de subcadenas en un vector de caracteres.

Primero, cree un vector de caracteres.

str = 'Find the starting indices of substrings in a character vector';

Busque la subcadena in.

k = strfind(str,'in')

k = 1×5

     2    15    19    36    41

Hay cinco instancias en str.

Busque la subcadena In.

k = strfind(str,'In')

k =

     []

Puesto que strfind distingue entre mayúsculas y minúsculas, no es posible encontrar la subcadena. k es un arreglo vacío.

Busque los espacios en blanco en str.

k = strfind(str,' ')

k = 1×9

     5     9    18    26    29    40    43    45    55

Hay diez espacios en blanco en str.

Encontrar letras y palabras utilizando patrones

Desde la versión R2020b

Cree un vector de caracteres.

str = 'Find the letters.'

str = 
'Find the letters.'

Cree un patrón que coincida con secuencias de letras utilizando la función lettersPattern.

pat = lettersPattern

pat = pattern
  Matching:

    lettersPattern

Busque el índice de cada letra. Mientras que pat coincide con una secuencia de letras de cualquier longitud, strfind se detiene en cuanto encuentra una coincidencia y, a continuación, continúa hasta la siguiente coincidencia. Por ejemplo, 'Find' y 'F' son coincidencias para lettersPattern, puesto que no se especifica el número de letras para una coincidencia. Pero strfind coincide primero con 'F' y devuelve su índice. Después, strfind coincide con 'i', etc. (puede llamar a lettersPattern con un argumento opcional que especifique el número de letras con las que se debe coincidir).

k = strfind(str,pat)

k = 1×14

     1     2     3     4     6     7     8    10    11    12    13    14    15    16

Para encontrar los inicios de las palabras, llame a lettersPattern con límites. La función letterBoundary coincide con un límite entre letras y caracteres que no son letras.

pat = letterBoundary + lettersPattern

pat = pattern
  Matching:

    letterBoundary + lettersPattern

k = strfind(str,pat)

k = 1×3

     1     6    10

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

Encontrar subcadenas en un arreglo de celdas

Busque los índices de inicio de subcadenas en un arreglo de celdas de vectores de caracteres.

Cree un arreglo de celdas de vectores de caracteres.

str = {'How much wood would a woodchuck chuck';
       'if a woodchuck could chuck wood?'};

Busque wood en str.

idx = strfind(str,'wood')

idx=2×1 cell array
    {[10 23]}
    {[ 6 28]}

Examine el arreglo de celdas de salida para encontrar las instancias de wood.

idx{:,:}

ans = 1×2

    10    23

ans = 1×2

     6    28

La subcadena wood ocurre en los índices 10 y 23 en el primer vector de caracteres, y en los índices 6 y 28 en el segundo vector de caracteres.

Devolver los índices en un arreglo de celdas

Busque las instancias de una subcadena en un vector de caracteres. Fuerce a strfind a devolver los índices de esas instancias en un arreglo de celdas. A continuación, muestre los índices.

Cree un vector de caracteres y busque las instancias del patrón ain.

str = 'The rain in Spain.';
k = strfind(str,'ain','ForceCellOutput',true)

k = 1x1 cell array
    {[6 15]}

strfind devuelve una celda escalar con un arreglo numérico, que contiene índices de instancias de la subcadena ain en str. Para acceder al arreglo numérico dentro de la celda, use llaves.

k{1}

ans = 1×2

     6    15

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

escalar de cadena | vector de caracteres | Escalar de pattern (desde la versión R2020b)

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

• Escalar de cadena

• Vector de caracteres

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

cellOutput — Indicador para forzar que la salida se devuelva como arreglo de celdas

false (predeterminado) | true | 0 | 1

Indicador para forzar que la salida se devuelva como arreglo de celdas, especificado como false, true, 0 o 1.

Argumentos de salida

k — Índices de instancias de pat

arreglo

Índices de instancias de pat, devueltos como arreglo. Si no se encuentra pat, k es un arreglo vacío [].

• Si str es un vector de caracteres o un escalar de cadena, k es un vector de dobles que indica el índice de cada instancia de pat.

• Si str es un arreglo de celdas de vectores de caracteres o un arreglo de cadenas, k es un arreglo de celdas. Para cada fragmento de texto en str, la celda correspondiente de k contiene un vector de dobles que indica el índice de cada instancia de pat.

Sugerencias

• Si pat es un vector de caracteres o un escalar de cadena sin caracteres ('' o ""), strfind devuelve un arreglo vacío.

• Se recomienda la función contains para encontrar patrones dentro de arreglos de cadenas.

Capacidades ampliadas

Arreglos altos

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

Notas y limitaciones de uso:

• La entrada de texto debe ser un arreglo alto de cadenas o un arreglo alto de celdas de vectores de caracteres.

• La entrada de patrón debe ser una cadena simple y no puede ser un arreglo alto o un objeto de patrón.

• La salida es un arreglo de celdas alto de vectores de índices, con un elemento por cadena de entrada.

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 debe ser un escalar de cadena o un vector de caracteres.

• El código generado devuelve una salida vacía como arreglo de caracteres de 1 por 0.

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 un entorno basado en subprocesos.

Arreglos distribuidos

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

Notas y limitaciones de uso:

• str debe ser un arreglo de cadenas o un arreglo de celdas de vectores de caracteres.

Para obtener más información, consulte Run MATLAB Functions with Distributed Arrays (Parallel Computing Toolbox).

Historial de versiones

Introducido antes de R2006a

Consulte también

count | replace | strtok | strcmp | regexp | split | contains | pattern | startsWith | endsWith | matches | extract

Temas

• Crear arreglos de cadenas
• Buscar y reemplazar texto
• Build Pattern Expressions