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 值。

參數：

sep：str 或 array-like: 如果是 str，則在列表條目之間使用分隔符。如果array-like，則將某個位置的字符串用作列表條目對應行的分隔符。
string_na_rep：str，默認無: 此字符將代替係列中的空字符串(不是空字符串)，但僅當係列包含列表元素並且這些列表至少有一個非空字符串時才會考慮。如果 string_na_rep 是 None ，則默認為空白空間“”。
sep_na_rep：str，默認無: 此字符將代替 sep 中的任何空字符串(不是空字符串)。僅當sep 為array-like 時才能使用此參數。如果 sep_na_rep 是 None ，則默認為空白空間“”。

係列/索引：對象: 通過分隔符的中間出現連接的列表條目。

拋出：

ValueError

如果在 sep 為 str 時提供了 sep_na_rep。
如果 sep 是 array-like 並且與係列/索引的長度不同。

TypeError

如果 string_na_rep 或 sep_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。非經特殊聲明，原始代碼版權歸原作者所有，本譯文未經允許或授權，請勿轉載或複製。

用法:

參數：

返回：

拋出：

例子：