join

合并字符串

语法

newStr = join(str)

newStr = join(str,delimiter)

newStr = join(str,dim)

newStr = join(str,delimiter,dim)

说明

newStr = join(str) 通过联接输入数组的连续元素，在它们之间放置空格字符，从而将 str 中的文本合并在一起。str 可以是字符串数组或字符向量元胞数组。newStr 的数据类型与 str 相同。

• 如果 str 是 1×N 或 N×1 字符串数组或元胞数组，则 newStr 是字符串标量或包含一个字符向量的元胞数组。

• 如果 str 是 M×N 字符串数组或元胞数组，则 newStr 是 M×1 字符串数组或元胞数组。

对于任意大小的字符串数组或元胞数组，join 将沿大小不等于 1 的最后一个 str 维度串联元素。

newStr = join(str,delimiter) 将 str 中的文本合并起来，并在 str 的元素之间放置 delimiter 的元素，而不是空格字符。

如果 delimiter 参量是由不同分隔符组成的数组，而且 str 在已合并的维度上有 N 个元素，则 delimiter 在同一个维度上必须有 N–1 个元素。delimiter 的其他维度的大小必须为 1 或与 str 的对应维度大小相同。

newStr = join(str,dim) 将 str 中的元素沿维度 dim 合并起来。

newStr = join(str,delimiter,dim) 将 str 中的元素沿维度 dim 合并起来，并在 str 的元素之间放置 delimiter 的元素。

示例

合并字符串数组中的字符串

创建一个字符串数组。您可以使用双引号创建字符串。

str = ["Carlos","Sada";
       "Ella","Olsen";
       "Diana","Lee"]

str = 3x2 string
    "Carlos"    "Sada" 
    "Ella"      "Olsen"
    "Diana"     "Lee"  

使用 join 函数合并字符串。join 串联 str 中的字符串，并在字符串之间放置空格字符。join 沿第二个维度串联，因为这是大小不等于 1 的最后一个维度。

newStr = join(str)

newStr = 3x1 string
    "Carlos Sada"
    "Ella Olsen"
    "Diana Lee"

使用分隔符合并字符串数组的元素

合并字符串数组中的元素。在 str 中的字符串之间插入不同的文本段，而不是空格。

创建一个字符串数组。

str = ["x","y","z";
       "a","b","c"]

str = 2x3 string
    "x"    "y"    "z"
    "a"    "b"    "c"

使用短划线串联字符串。

newStr = join(str,"-")

newStr = 2x1 string
    "x-y-z"
    "a-b-c"

使用符号串联字符串，使输出字符串表示方程。delimiters 参量必须是 2×2 数组，因为 str 是 2×3 数组。

delimiters = [" + "," = ";
              " - "," = "];
newStr = join(str,delimiters)

newStr = 2x1 string
    "x + y = z"
    "a - b = c"

沿指定维度合并字符串数组

创建一个字符串数组。

str = ["Carlos","Sada";
       "Ella","Olsen";
       "Diana","Lee"]

str = 3x2 string
    "Carlos"    "Sada" 
    "Ella"      "Olsen"
    "Diana"     "Lee"  

沿第一个维度合并 str 中的字符串。默认情况下，join 函数沿大小不等于 1 的最后一个维度合并字符串。要沿第一个维度合并字符串，请将其指定为附加输入参量。

newStr = join(str,1)

newStr = 1x2 string
    "Carlos Ella Diana"    "Sada Olsen Lee"

输入参数

str — 输入文本

字符串数组 | 字符向量元胞数组

输入文本，指定为字符串数组或字符向量元胞数组。

delimiter — 用来联接字符串的分隔符

' ' (默认) | 字符向量 | 字符向量元胞数组 | 字符串数组

用来联接字符串的分隔符，指定为字符向量、字符向量元胞数组或字符串数组。join 通过用分隔符联接字符串元素来构成输出字符串数组。

join 将 delimiter 中的所有字符作为字面文本插入，包括转义的字符序列。

dim — 联接字符串时所沿的维度

正整数

字符串的联接维度，指定为正整数。如果不指定 dim，则默认值为大小不等于 1 的最后一个维度。

输出参量

newStr — 输出文本

字符串数组 | 字符向量元胞数组

输出文本，以字符串数组或字符向量元胞数组形式返回。newStr 的数据类型与输入文本相同，联接维度的大小为 1。

扩展功能

tall 数组

对行数太多而无法放入内存的数组进行计算。

此函数完全支持 tall 数组。有关详细信息，请参阅 tall 数组。

基于线程的环境

使用 MATLAB® backgroundPool 在后台运行代码或使用 Parallel Computing Toolbox™ ThreadPool 加快代码运行速度。

此函数完全支持基于线程的环境。有关详细信息，请参阅在基于线程的环境中运行 MATLAB 函数。

分布式数组

使用 Parallel Computing Toolbox™ 在集群的组合内存中对大型数组进行分区。

此函数完全支持分布式数组。有关详细信息，请参阅Run MATLAB Functions with Distributed Arrays (Parallel Computing Toolbox)。

版本历史记录

在 R2016b 中推出

另请参阅

split | regexp | string | splitlines | newline | compose | sprintf | plus