当前位置: 首页>>编程示例 >>用法及示例精选 >>正文


Python cudf.core.column.string.StringMethods.join用法及代码示例

用法:

StringMethods.join(sep=None, string_na_rep=None, sep_na_rep=None) → SeriesOrIndex

连接列表作为元素包含在系列/索引中,并带有传递的分隔符。

如果 Series 的元素本身是列表,则使用传递给函数的分隔符连接这些列表的内容。此函数等效于 str.join() 。在系列中的列表仅包含 None 的特殊情况下,将始终返回 <NA> /None 值。

参数

sepstr 或 array-like

如果是 str,则在列表条目之间使用分隔符。如果array-like,则将某个位置的字符串用作列表条目对应行的分隔符。

string_na_repstr,默认无

此字符将代替系列中的空字符串(不是空字符串),但仅当系列包含列表元素并且这些列表至少有一个非空字符串时才会考虑。如果 string_na_repNone ,则默认为空白空间“”。

sep_na_repstr,默认无

此字符将代替 sep 中的任何空字符串(不是空字符串)。仅当sep 为array-like 时才能使用此参数。如果 sep_na_repNone ,则默认为空白空间“”。

返回

系列/索引:对象

通过分隔符的中间出现连接的列表条目。

抛出

ValueError
  • 如果在 sep 为 str 时提供了 sep_na_rep
  • 如果 sep 是 array-like 并且与系列/索引的长度不同。
TypeError
  • 如果 string_na_repsep_na_rep 不是标量值。
  • 如果sep 不属于以下类型:str 或array-like。

例子

>>> import cudf
>>> ser = cudf.Series([['a', 'b', 'c'], ['d', 'e'], ['f'], ['g', ' ', 'h']])
>>> ser
0    [a, b, c]
1       [d, e]
2          [f]
3    [g,  , h]
dtype: list
>>> ser.str.join(sep='-')
0    a-b-c
1      d-e
2        f
3    g- -h
dtype: object

sep 可以输入 array-like:

>>> ser.str.join(sep=['-', '+', '.', '='])
0    a-b-c
1      d+e
2        f
3    g= =h
dtype: object

如果实际系列没有列表,则每个字符都由 sep 连接:

>>> ser = cudf.Series(['abc', 'def', 'ghi'])
>>> ser
0    abc
1    def
2    ghi
dtype: object
>>> ser.str.join(sep='_')
0    a_b_c
1    d_e_f
2    g_h_i
dtype: object

如果列表包含至少一个有效字符串,我们可以使用 string_na_rep 替换列表中存在的 <NA> /None 值(包含所有 None 的列表将产生 <NA> /None 值):

>>> ser = cudf.Series([['a', 'b', None], [None, None, None], None, ['c', 'd']])
>>> ser
0          [a, b, None]
1    [None, None, None]
2                  None
3                [c, d]
dtype: list
>>> ser.str.join(sep='_', string_na_rep='k')
0    a_b_k
1     <NA>
2     <NA>
3      c_d
dtype: object

我们可以使用 sep_na_rep 替换 sep 列表中存在的 <NA> /None 值:

>>> ser.str.join(sep=[None, '^', '.', '-'], sep_na_rep='+')
0    a+b+
1    <NA>
2    <NA>
3     c-d
dtype: object

相关用法


注:本文由纯净天空筛选整理自rapids.ai大神的英文原创作品 cudf.core.column.string.StringMethods.join。非经特殊声明,原始代码版权归原作者所有,本译文未经允许或授权,请勿转载或复制。