strjoin

Join text in array

Syntax

Description

example

str = strjoin(C) constructs a single piece of text, str, by linking each element in the array, C, with a single space. 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 =

  1×4 cell array

    '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: string({'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

More About

collapse all

Tips

  • Starting in R2016b, the join function is recommended to join elements of a string array.

See Also

| | | |

Introduced in R2013a

Was this topic helpful?