Combine strings - MATLAB append (2024)

Combine strings

collapse all in page

Syntax

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

Description

example

str = append(str1,...,strN) combines the text from str1,...,strN. Each input argument can be a string array, a character vector, or a cell array of character vectors.

  • If any input is a string array, then the output is a string array.

  • If any input is a cell array, and none are string arrays, then the output is a cell array of character vectors.

  • If all inputs are character vectors, then the output is a character vector.

Unlike the strcat function, append preserves trailing whitespace characters from input arguments of all data types.

Examples

collapse all

Combine Strings

Open Live Script

Create two strings.

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

Combine them using the append function.

str = append(str1,str2)
str = "GoodMorning"

To add a space between the input strings, specify a space character as another input argument.

str = append(str1,' ',str2)

As an alternative, you can use the plus operator to combine strings.

str = str1 + ' ' + str2
str = "Good Morning"

However, the best practice is to use append when you do not know whether the input arguments are strings, character vectors, or cell arrays of character vectors.

Combine Character Vectors

Open Live Script

Create two character vectors, with the first character vector having a trailing whitespace character.

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

Combine them into one character vector.

chr3 = append(chr1,chr2)
chr3 = 'Hello World'

The append function always preserves trailing whitespace characters, unlike the strcat function. (strcat removes trailing whitespace characters from character vectors.)

chr4 = strcat(chr1,chr2)
chr4 = 'HelloWorld'

Combine Arrays of Text

Open Live Script

You can combine string arrays or cell arrays of character vectors, element by element. Also, you can append a single piece of text to the elements of an input array.

Create an array of file names.

names = ["data" "report" "slides"]
names = 1x3 string "data" "report" "slides"

Create an array of file extension names, with a different extension for each element of names.

ext = [".xlsx" ".docx" ".pptx"]
ext = 1x3 string ".xlsx" ".docx" ".pptx"

Combine the file names and extensions.

str1 = append(names,ext)
str1 = 1x3 string "data.xlsx" "report.docx" "slides.pptx"

To append the same extension to each name, use a character vector or a string scalar.

str2 = append(names,'.mat')
str2 = 1x3 string "data.mat" "report.mat" "slides.mat"

Implicit Expansion

Open Live Script

The append function supports implicit expansion of arrays. For example, you can combine strings from a column vector and a row vector to form a two-dimensional string array.

Create a column vector of strings. Then create a row vector.

str1 = ["A";"B";"C"]
str1 = 3x1 string "A" "B" "C"
str2 = ["1" "2" "3" "4"]
str2 = 1x4 string "1" "2" "3" "4"

Combine str1 and str2.

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

Input Arguments

collapse all

str1,...,strNInput text
string arrays | character vectors | cell arrays of character vectors

Input text, specified as string arrays, character vectors, or cell arrays of character vectors.

The append function supports input arguments that have compatible sizes.

String arrays and cell arrays of character vectors have compatible sizes if, for each dimension, one of these conditions is true:

  • The lengths of that dimension are equal for all arrays.

  • For one or more arrays, the length of that dimension is equal to 1. For the other arrays, the lengths are not equal to 1 but are equal to each other.

Character vectors are always compatible with all other input arguments. You can always append a character vector to another character vector, or to the elements of a string array or cell array of character vectors.

For more information on combining arrays with compatible sizes, see Compatible Array Sizes for Basic Operations.

Extended Capabilities

Thread-Based Environment
Run code in the background using MATLAB® backgroundPool or accelerate code with Parallel Computing Toolbox™ ThreadPool.

Version History

Introduced in R2019a

See Also

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

MATLAB Command

You clicked a link that corresponds to this MATLAB command:

 

Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.

Combine strings - MATLAB append (1)

Select a Web Site

Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .

You can also select a web site from the following list:

Americas

  • América Latina (Español)
  • Canada (English)
  • United States (English)

Europe

  • Belgium (English)
  • Denmark (English)
  • Deutschland (Deutsch)
  • España (Español)
  • Finland (English)
  • France (Français)
  • Ireland (English)
  • Italia (Italiano)
  • Luxembourg (English)
  • Netherlands (English)
  • Norway (English)
  • Österreich (Deutsch)
  • Portugal (English)
  • Sweden (English)
  • Switzerland
    • Deutsch
    • English
    • Français
  • United Kingdom (English)

Asia Pacific

  • Australia (English)
  • India (English)
  • New Zealand (English)
  • 中国
  • 日本 (日本語)
  • 한국 (한국어)

Contact your local office

Combine strings - MATLAB append (2024)
Top Articles
Latest Posts
Article information

Author: Delena Feil

Last Updated:

Views: 6046

Rating: 4.4 / 5 (65 voted)

Reviews: 80% of readers found this page helpful

Author information

Name: Delena Feil

Birthday: 1998-08-29

Address: 747 Lubowitz Run, Sidmouth, HI 90646-5543

Phone: +99513241752844

Job: Design Supervisor

Hobby: Digital arts, Lacemaking, Air sports, Running, Scouting, Shooting, Puzzles

Introduction: My name is Delena Feil, I am a clean, splendid, calm, fancy, jolly, bright, faithful person who loves writing and wants to share my knowledge and understanding with you.