join

Combine strings.

Syntax

• res = join(str)

• res = join(str, delimiter)

• res = join(str, dim)

• res = join(str, delimiter, dim)

Input argument

• str - a string, string array or cell of strings.

• delimiter - a string, string array or cell of strings:Characters used to separate and join strings.

• dim - positive integer: Dimension along which to join strings.

Output argument

• res - a string, string array or cell of strings.

Description

res = join(str) combines the elements of str into a single text by joining them with a space character as the default delimiter.

The input, str, can be either a string array or a cell array of character vectors. The output, res, has the same data type as str.

If str is a 1-by-N or N-by-1 string array or cell array, res will be a string scalar or a cell array containing a single character vector.

If str is an M-by-N string array or cell array, res will be an M-by-1 string array or cell array.

For arrays of any size, join concatenates elements along the last dimension with a size greater than 1.

res = join(str, delimiter) joins the elements of str using the specified delimiter instead of the default space character.

If delimiter is an array of multiple delimiters, and str has N elements along the joining dimension, delimiter must have N–1 elements along the same dimension. All other dimensions of delimiter must either have size 1 or match the size of the corresponding dimensions of str.

res = join(str, dim) combines the elements of str along the specified dimension dim.

res = join(str, delimiter, dim) joins the elements of str along the specified dimension dim, using delimiter to separate them.

Example

str = ["x","y","z"; "a","b","c"];
delimiters = [" + "," = "; " - "," = "];
R = join(str, delimiters)

See also

append, strcat.

History

Version	Description
1.10.0	initial version

Author

Allan CORNET