startsWith

Determinar si las cadenas comienzan con un patrón

Sintaxis

TF = startsWith(str,pat)

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

Descripción

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

Si pat es un arreglo que contiene varios patrones, startsWith devuelve 1 si encuentra que str comienza con cualquier elemento de pat.

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

Ejemplos

Detectar texto al inicio de una cadena

Cree un arreglo de cadenas que contenga nombres de archivo. Determine qué nombres de archivo comienzan con la palabra data.

str = ["abstract.docx","data.tar","code.m"; ...
       "data-analysis.ppt","results.ptx","summary.ppt"]

str = 2×3 string
    "abstract.docx"        "data.tar"       "code.m"     
    "data-analysis.ppt"    "results.ptx"    "summary.ppt"

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 comience con data.

pat = "data";
TF = startsWith(str,pat)

TF = 2×3 logical array

   0   1   0
   1   0   0

Visualice los nombres de archivo que comienzan con data. Vuelva a indexar en str utilizando TF.

str(TF)

ans = 2×1 string
    "data-analysis.ppt"
    "data.tar"

Detectar inicios de rutas utilizando un patrón

Desde la versión R2020b

Cree un arreglo de cadenas que tenga referencias a archivos, incluidas las rutas completas para archivos locales y URL de los remotos.

str = ["C:\Temp\MyReport.docx";
       "D:\Data\Experiment1\Trial1\Sample1.csv";
       "https://example.com/Slides.pptx"]

str = 3×1 string
    "C:\Temp\MyReport.docx"
    "D:\Data\Experiment1\Trial1\Sample1.csv"
    "https://example.com/Slides.pptx"

Para encontrar las rutas que comienzan con una letra de unidad de disco, cree un patrón que coincida con una letra seguida de dos puntos.

pat = lettersPattern(1) + ":"

pat = pattern
  Matching:

    lettersPattern(1) + ":"

Determine qué elementos de str comienzan con ese patrón. El patrón pat no coincide con "https:" porque lettersPattern(1) coincide solo con una letra.

TF = startsWith(str,pat)

TF = 3×1 logical array

   1
   1
   0

Visualice los nombres de archivo coincidentes.

str(TF)

ans = 2×1 string
    "C:\Temp\MyReport.docx"
    "D:\Data\Experiment1\Trial1\Sample1.csv"

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

Probar un inicio de cadena con varias subcadenas

Cree un arreglo de cadenas que contenga nombres de archivo. Determine qué nombres de archivo comienzan con abstract o data.

str = ["abstract.docx","data.tar.gz","mycode.m","results.ptx"]

str = 1×4 string
    "abstract.docx"    "data.tar.gz"    "mycode.m"    "results.ptx"

pat = ["abstract","data"];
TF = startsWith(str,pat)

TF = 1×4 logical array

   1   1   0   0

Visualice las cadenas que comienzan con abstract o data. Vuelva a indexar en str utilizando TF.

str(TF)

ans = 1×2 string
    "abstract.docx"    "data.tar.gz"

Ignorar las mayúsculas y las minúsculas cuando se prueba un inicio de cadena

Cree un arreglo de cadenas que contenga nombres de archivo. Determine qué nombres de archivo comienzan con data ignorando las mayúsculas y las minúsculas.

str = ["DATA.TAR.GZ","data.xlsx","SUMMARY.PPT","tmp.gz"]

str = 1×4 string
    "DATA.TAR.GZ"    "data.xlsx"    "SUMMARY.PPT"    "tmp.gz"

pat = "data";
TF = startsWith(str,pat,'IgnoreCase',true)

TF = 1×4 logical array

   1   1   0   0

Visualice las cadenas que comienzan con data. Vuelva a indexar en str utilizando TF.

str(TF)

ans = 1×2 string
    "DATA.TAR.GZ"    "data.xlsx"

Determinar si un vector de caracteres comienza con subcadenas

Cree un vector de caracteres que contenga el nombre de un archivo. Determine si el nombre comienza con diferentes subcadenas.

chr = 'data-analysis.ppt'

chr = 
'data-analysis.ppt'

TF = startsWith(chr,'data')

TF = logical
   1

TF = startsWith(chr,'test')

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 startsWith 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 pattern 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 | contains | endsWith | extract | matches | replace | split | pattern | lettersPattern

Temas

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