strcat

Concatenate strings horizontally

Syntax

s = strcat(s1,...,sN)

Description

Note

append is recommended over strcat because it provides greater flexibility and allows vectorization. For additional information, see Alternative Functionality.

s = strcat(s1,...,sN) horizontally concatenates the text in its input arguments. Each input argument can be a character array, a cell array of character vectors, or a string array.

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

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

• If all inputs are character arrays, then the result is a character array.

For character array inputs, strcat removes trailing ASCII whitespace characters: space, tab, vertical tab, newline, carriage return, and form feed. For cell array and string array inputs, strcat does not remove trailing white space.

For faster performance and to preserve trailing whitespace characters, use append.

Examples

Concatenate Two Character Vectors

Create two character vectors. Use strcat to horizontally concatenate the two vectors.

s1 = 'Good';
s2 = 'morning';
s = strcat(s1,s2)

s = 
'Goodmorning'

Concatenate Two Cell Arrays

Create two cell arrays of character vectors. Use strcat to horizontally concatenate the elements of the two cell arrays.

s1 = {'abcde','fghi'};
s2 = {'jkl','mn'};
s = strcat(s1,s2)

s = 1x2 cell
    {'abcdejkl'}    {'fghimn'}

Concatenate Two Cell Arrays with Scalar Cell Array

Create two cell arrays of character vectors. Create a scalar cell array containing the character vector ','. Use strcat to horizontally concatenate the elements of the two cell arrays and the cell scalar.

firstnames = {'Abraham'; 'George'};
lastnames = {'Lincoln'; 'Washington'};
commas = {', '};
names = strcat(lastnames, commas, firstnames)

names = 2x1 cell
    {'Lincoln, Abraham'  }
    {'Washington, George'}

Concatenate Two String Arrays

Concatenate text with the strcat function. Note that when concatenated in this way the output string will insert a whitespace character between the input strings.

str1 = ["John ","Mary "];
str2 = ["Smith","Jones"];
str = strcat(str1,str2)

str = 1x2 string
    "John Smith"    "Mary Jones"

Strings and character vectors can be combined using strcat. When concatenating strings with character vectors a whitespace will not be added. Concatenate a character vector onto each element of the string array.

str3 = strcat(str,', M.D.')

str3 = 1x2 string
    "John Smith, M.D."    "Mary Jones, M.D."

To combine strings and character vectors, consider using + instead.

str4 = str + ', M.D.'

str4 = 1x2 string
    "John Smith, M.D."    "Mary Jones, M.D."

Input Arguments

s1,...,sN — Input text

character arrays | cell array of character vectors | string arrays

Input text, specified as character arrays, cell arrays of character vectors, or string arrays. When combining string or cell arrays with character arrays, the string or cell arrays must be either scalars or column vectors with the same number of rows as the character arrays.

Data Types: char | cell | string

Alternative Functionality

Update existing code that makes use of strcat to use append or syntaxes specific to character vectors and strings. Note that append does not remove trailing whitespace characters. Character arrays also can be concatenated using left and right square brackets. String arrays can be concatenated using the + operator. For example:

Not Recommended	Recommended	Square Brackets	+ Operator
char1 = 'Good '; char2 = 'Morning'; char3 = strcat(char1,char2) char3 = 'GoodMorning'	char1 = 'Good '; char2 = 'Morning'; char3 = append(char1,char2) char3 = 'Good Morning'	char1 = 'Good '; char2 = 'Morning'; char3 = [char1 char2] char3 = 'Good Morning'	str1 = "Good "; str2 = "Morning"; str3 = str1 + str2 str3 = "Good Morning"

Extended Capabilities

C/C++ Code Generation
Generate C and C++ code using MATLAB® Coder™.

Thread-Based Environment

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

This function fully supports thread-based environments. For more information, see Run MATLAB Functions in Thread-Based Environment.

Version History

Introduced before R2006a