join

Combinar cadenas

Sintaxis

newStr = join(str)

newStr = join(str,delimiter)

newStr = join(str,dim)

newStr = join(str,delimiter,dim)

Descripción

newStr = join(str) combina el texto de str uniendo elementos consecutivos del arreglo de entrada, colocando un carácter de espacio entre ellos. str puede ser un arreglo de cadenas o un arreglo de celdas de vectores de caracteres. newStr tiene el mismo tipo de datos que str.

• Si str es un arreglo de cadenas o de celdas de 1 por N o de N por 1, newStr es un escalar de cadena o un arreglo de celdas que contiene un vector de caracteres.

• Si str es un arreglo de cadenas o un arreglo de celdas de M por N, newStr es un arreglo de cadenas o un arreglo de celdas de M por 1.

Para un arreglo de cadenas o de celdas de cualquier tamaño, join concatena elementos a lo largo de la última dimensión de str con un tamaño que no es igual a 1.

newStr = join(str,delimiter) combina el texto de str y coloca los elementos de delimiter entre los elementos de str en lugar de un carácter de espacio.

Si el argumento delimiter es un arreglo de diferentes delimitadores y str tiene N elementos a lo largo de la dimensión que se une, delimiter debe tener N–1 elementos a lo largo de la misma dimensión. Las otras dimensiones de delimiter deben tener un tamaño de 1 o el mismo tamaño que la dimensión correspondiente de str.

newStr = join(str,dim) combina los elementos de str a lo largo de la dimensión dim.

newStr = join(str,delimiter,dim) combina los elementos de str a lo largo de la dimensión dim y coloca los elementos de delimiter entre los elementos de str.

Ejemplos

Combinar cadenas en un arreglo de cadenas

Cree un arreglo de cadenas. Puede crear cadenas utilizando comillas dobles.

str = ["Carlos","Sada";
       "Ella","Olsen";
       "Diana","Lee"]

str = 3×2 string
    "Carlos"    "Sada" 
    "Ella"      "Olsen"
    "Diana"     "Lee"  

Combine las cadenas usando la función join. join concatena las cadenas de str y coloca un carácter de espacio entre ellas. join concatena a lo largo de la segunda dimensión, ya que es la última dimensión con un tamaño que no es igual a 1.

newStr = join(str)

newStr = 3×1 string
    "Carlos Sada"
    "Ella Olsen"
    "Diana Lee"

Combinar elementos de arreglos de cadenas con delimitadores

Combine elementos de un arreglo de cadenas. En lugar de espacios, inserte distintos fragmentos de texto entre las cadenas de str.

Cree un arreglo de cadenas.

str = ["x","y","z";
       "a","b","c"]

str = 2×3 string
    "x"    "y"    "z"
    "a"    "b"    "c"

Concatene las cadenas con guiones entre ellas.

newStr = join(str,"-")

newStr = 2×1 string
    "x-y-z"
    "a-b-c"

Concatene las cadenas con símbolos que hagan que las cadenas de salida representen ecuaciones. El argumento delimiters debe ser un arreglo de 2 por 2 porque str es un arreglo de 2 por 3.

delimiters = [" + "," = ";
              " - "," = "];
newStr = join(str,delimiters)

newStr = 2×1 string
    "x + y = z"
    "a - b = c"

Combinar arreglos de cadenas a lo largo de una dimensión especificada

Cree un arreglo de cadenas.

str = ["Carlos","Sada";
       "Ella","Olsen";
       "Diana","Lee"]

str = 3×2 string
    "Carlos"    "Sada" 
    "Ella"      "Olsen"
    "Diana"     "Lee"  

Combine las cadenas de str a lo largo de la primera dimensión. De forma predeterminada, la función join combina cadenas a lo largo de la última dimensión con un tamaño que no es igual a 1. Para combinar las cadenas a lo largo de la primera dimensión, especifíquela como un argumento de entrada adicional.

newStr = join(str,1)

newStr = 1×2 string
    "Carlos Ella Diana"    "Sada Olsen Lee"

Argumentos de entrada

str — Texto de entrada

arreglo de cadenas | arreglo de celdas de vectores de caracteres

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

delimiter — Caracteres delimitantes para unir cadenas

' ' (predeterminado) | vector de caracteres | arreglo de celdas de vectores de caracteres | arreglo de cadenas

Caracteres delimitantes para unir cadenas, especificados como vector de caracteres, arreglo de celdas de vectores de caracteres o arreglo de cadenas. join forma el arreglo de cadenas de salida combinando elementos de cadenas con delimitadores entre ellos.

join inserta todos los caracteres en delimiter como texto literal, incluidas secuencias de caracteres de escape.

dim — Dimensión a lo largo de la que unir cadenas

entero positivo

Dimensión a lo largo de la que unir cadenas, especificada como entero positivo. Si no se especifica dim, el valor predeterminado es la última dimensión con un tamaño que no sea igual a 1.

Argumentos de salida

newStr — Texto de salida

arreglo de cadenas | arreglo de celdas de vectores de caracteres

Texto de salida, devuelto como arreglo de cadenas o arreglo de celdas de vectores de caracteres. newStr tiene el mismo tipo de datos que el texto de entrada y tiene el tamaño de 1 a lo largo de la dimensión que se está uniendo.

Capacidades ampliadas

Arreglos altos

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

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

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

split | regexp | string | splitlines | newline | compose | sprintf | plus