Main Content

strjoin

Join strings in array

Description

example

Note

join is recommended over strjoin because it provides greater flexibility and allows vectorization. For more information, see Alternative Functionality.

str = strjoin(C) constructs str by linking the elements of C with a space between consecutive elements. C can be a cell array of character vectors or a string array.

example

str = strjoin(C,delimiter) constructs str by linking each element of C with the elements in delimiter.

Examples

collapse all

Join individual character vectors in a cell array of character vectors, C, with a single space.

C = {'one','two','three'};
str = strjoin(C)
str = 
'one two three'

Join the character vectors in a cell array into one character vector. Specify a comma followed by a space character as the delimiter.

C = {'Newton','Gauss','Euclid','Lagrange'}
C = 1x4 cell
    {'Newton'}    {'Gauss'}    {'Euclid'}    {'Lagrange'}

str = strjoin(C,', ')
str = 
'Newton, Gauss, Euclid, Lagrange'

Specify multiple different delimiters in a cell array of character vectors. The delimiter cell array must have one fewer element than C.

C = {'one','two','three'};
str = strjoin(C,{' + ',' = '})
str = 
'one + two = three'

Input Arguments

collapse all

Input text, specified as a 1-by-n cell array of character vectors or string array.

Example: {'The','rain','in','Spain'}

Example: ["Four","score","and","seven"]

Data Types: cell | string

Delimiting characters, specified as a character vector, a 1-by-n cell array of character vectors, or a 1-by-n string array.

  • If delimiter is a character vector, then strjoin forms str by inserting delimiter between each element of C. The delimiter input can include any of these escape sequences:

    \\

    Backslash

    \0

    Null

    \a

    Alarm

    \b

    Backspace

    \f

    Form feed

    \n

    New line

    \r

    Carriage return

    \t

    Horizontal tab

    \v

    Vertical tab

  • If delimiter is a cell array of character vectors, then it must contain one fewer element than C. Each element in the cell array must contain a character vector. strjoin forms str by interleaving the elements of delimiter and C. All characters in delimiter are inserted as literal text, and escape sequences are not supported.

Example: ', '

Example: {',',' '}

Data Types: char | cell | string

Alternative Functionality

Update code that makes use of strjoin to use join instead. strjoin returns a character vector if the input is a cell array of character vectors and returns a string scalar if the input is a string array. join returns a text scalar of the same type as the input. For example:

Not RecommendedDirect ReplacementMatch Original Behavior
C = {'one','two','three'}; 
str = strjoin(C)
str =

    'one two three'
C = {'one','two','three'}; 
str = join(C)
str =

    {'one two three'}
C = {'one','two','three'}; 
str = char(join(C))
str =

    'one two three'

Extended Capabilities

Version History

Introduced in R2013a