Main Content

append

Descripción

ejemplo

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

contraer todo

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.

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'

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 = 1x3 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 = 1x3 string
    ".xlsx"    ".docx"    ".pptx"

Combine los nombres de archivo y las extensiones.

str1 = append(names,ext)
str1 = 1x3 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 = 1x3 string
    "data.mat"    "report.mat"    "slides.mat"

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 = 3x1 string
    "A"
    "B"
    "C"

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

Combine str1 y str2.

str = append(str1,str2)
str = 3x4 string
    "A1"    "A2"    "A3"    "A4"
    "B1"    "B2"    "B3"    "B4"
    "C1"    "C2"    "C3"    "C4"

Argumentos de entrada

contraer todo

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

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

| | | | | | |