strjoin

Join strings in array

Syntax

``str = strjoin(C)``
``str = strjoin(C,delimiter)``

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'```

Version History

Introduced in R2013a