append

Combinar cadenas

Sintaxis

str = append(str1,...,strN)

Descripción

str = append(str1,...,strN) combina el texto de str1,...,strN. Cada argumento de entrada puede ser un arreglo de cadenas, un vector de caracteres o un arreglo de celdas de vectores de caracteres.

• Si algún valor de entrada es un arreglo de cadenas, la salida es un arreglo de cadenas.

• Si algún valor de entrada es un arreglo de celdas y ninguno es un arreglo de cadenas, la salida es un arreglo de celdas de vectores de caracteres.

• Si todas las entradas son vectores de caracteres, la salida es un vector de caracteres.

A diferencia de la función strcat, append conserva los caracteres de espacio en blanco al final de los argumentos de entrada de todos los tipos de datos.

Ejemplos

Combinar cadenas

Cree dos cadenas.

str1 = "Good";
str2 = "Morning";

Combínelas usando la función append.

str = append(str1,str2)

str = 
"GoodMorning"

Para añadir un espacio entre las cadenas de entrada, especifique un carácter de espacio como otro argumento de entrada.

str = append(str1,' ',str2)

str = 
"Good Morning"

Como alternativa, puede utilizar el operador plus para combinar cadenas.

str = str1 + ' ' + str2

str = 
"Good Morning"

Sin embargo, se recomienda utilizar append cuando no se sabe si los argumentos de entrada son cadenas, vectores de caracteres o arreglos de celdas de vectores de caracteres.

Combinar vectores de caracteres

Cree dos vectores de caracteres, el primero de ellos con un carácter de espacio en blanco al final.

chr1 = 'Hello ';
chr2 = 'World';

Combínelos en un vector de caracteres.

chr3 = append(chr1,chr2)

chr3 = 
'Hello World'

La función append siempre conserva los caracteres de espacio en blanco al final, al contrario que la función strcat. (strcat elimina los caracteres de espacio en blanco al final de los vectores de caracteres).

chr4 = strcat(chr1,chr2)

chr4 = 
'HelloWorld'

Combinar arreglos de texto

Puede combinar arreglos de cadenas o arreglos de celdas de vectores de caracteres, elemento por elemento. Además, puede añadir un único fragmento de texto a los elementos de un arreglo de entrada.

Cree un arreglo de nombres de archivo.

names = ["data" "report" "slides"]

names = 1×3 string
    "data"    "report"    "slides"

Cree un arreglo de nombres de extensión de archivo, con una extensión diferente para cada elemento de names.

ext = [".xlsx" ".docx" ".pptx"]

ext = 1×3 string
    ".xlsx"    ".docx"    ".pptx"

Combine los nombres de archivo y las extensiones.

str1 = append(names,ext)

str1 = 1×3 string
    "data.xlsx"    "report.docx"    "slides.pptx"

Para añadir la misma extensión a cada nombre, utilice un vector de caracteres o un escalar de cadena.

str2 = append(names,'.mat')

str2 = 1×3 string
    "data.mat"    "report.mat"    "slides.mat"

Ampliación implícita

La función append es compatible con la ampliación implícita de arreglos. Por ejemplo, puede combinar cadenas de un vector columna y un vector fila para formar un arreglo de cadenas bidimensional.

Cree un vector columna de cadenas. A continuación, cree un vector fila.

str1 = ["A";"B";"C"]

str1 = 3×1 string
    "A"
    "B"
    "C"

str2 = ["1" "2" "3" "4"]

str2 = 1×4 string
    "1"    "2"    "3"    "4"

Combine str1 y str2.

str = append(str1,str2)

str = 3×4 string
    "A1"    "A2"    "A3"    "A4"
    "B1"    "B2"    "B3"    "B4"
    "C1"    "C2"    "C3"    "C4"

Argumentos de entrada

str1,...,strN — Texto de entrada

arreglos de cadenas | vectores de caracteres | arreglos de celdas de vectores de caracteres

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

La función append es compatible argumentos de entrada que tienen tamaños compatibles.

Los arreglos de cadenas y los arreglos de celdas de vectores de caracteres tienen tamaños compatibles si, para cada dimensión, una de estas condiciones es verdadera:

• Las longitudes de esa dimensión son iguales en todos los arreglos.

• En uno o más arreglos, la longitud de esa dimensión es igual a 1. En el resto de arreglos, las longitudes no son iguales a 1, pero sí iguales entre sí.

Los vectores de caracteres siempre son compatibles con el resto de argumentos de entrada. Siempre se puede añadir un vector de caracteres a otro vector de caracteres o a los elementos de un arreglo de cadenas o un arreglo de celdas de vectores de caracteres.

Para obtener más información sobre combinar arreglos con tamaños compatibles, consulte Tamaños de arreglos compatibles para operaciones básicas.

Capacidades ampliadas

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

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

Notas y limitaciones de uso:

• La función append no es compatible con la generación de código cuando el argumento de entrada es una combinación de arreglos de celdas heterogéneos y de tamaño variable.

• Todas las entradas de caracteres a append (incluidos los vectores de caracteres dentro de arreglos de celdas) deben ser vectores fila en el momento de la compilación.

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

Historial de versiones

Introducido en R2019a

Consulte también

cat | vertcat | horzcat | cellstr | strjoin | join | strcat | plus