Python pandas.Series.str.cat用法及代碼示例

用法: Series.str.cat(others=None, sep=None, na_rep=None, join='left')

使用給定的分隔符連接係列/索引中的字符串。

如果指定了others，則此函數將係列/索引和others 的元素逐元素連接起來。如果 others 未通過，則 Series/Index 中的所有值都將連接到具有給定 sep 的單個字符串中。

參數：

others：係列、索引、數據幀、np.ndarray 或 list-like

Series、Index、DataFrame、np.ndarray(一維或二維)和其他 list-likes 的字符串必須與調用 Series/Index 的長度相同，但索引對象除外(即 Series/Index/DataFrame)如果join 不是無。

如果其他是包含 Series、Index 或 np.ndarray (1-dim) 組合的 list-like，則所有元素都將被解包並且必須單獨滿足上述條件。

如果其他為 None，則該方法返回調用 Series/Index 中所有字符串的串聯。

sep：str，默認“”

不同元素/列之間的分隔符。默認情況下使用空字符串‘’。

na_rep：str 或無，默認無

為所有缺失值插入的表示：

如果na_rep 為None，並且others 為None，則從結果中省略係列/索引中的缺失值。
如果na_rep 為None，並且others 不是None，則在任何列(連接之前)中包含缺失值的行將在結果中具有缺失值。

join：{‘left’, ‘right’, ‘outer’, ‘inner’}，默認 ‘left’

確定調用 Series/Index 和 others 中的任何 Series/Index/DataFrame 之間的 join-style(沒有索引的對象需要匹配調用 Series/Index 的長度)。要禁用對齊，請在 others 中的任何係列/索引/數據幀上使用 .values。

str、係列或索引

如果others 為None，則返回str，否則返回對象的Series/Index(與調用者類型相同)。

例子：

當不通過 others 時，所有值都連接成一個字符串：

>>> s = pd.Series(['a', 'b', np.nan, 'd'])
>>> s.str.cat(sep=' ')
'a b d'

默認情況下，忽略 Series 中的 NA 值。使用 na_rep ，可以給它們一個表示：

>>> s.str.cat(sep=' ', na_rep='?')
'a b ? d'

如果指定了others，則將相應的值與分隔符連接起來。結果將是一係列字符串。

>>> s.str.cat(['A', 'B', 'C', 'D'], sep=',')
0    a,A
1    b,B
2    NaN
3    d,D
dtype:object

缺失值將在結果中保持缺失，但可以再次使用 na_rep 表示

>>> s.str.cat(['A', 'B', 'C', 'D'], sep=',', na_rep='-')
0    a,A
1    b,B
2    -,C
3    d,D
dtype:object

如果未指定sep，則將這些值連接起來而不進行分隔。

>>> s.str.cat(['A', 'B', 'C', 'D'], na_rep='-')
0    aA
1    bB
2    -C
3    dD
dtype:object

具有不同索引的係列可以在連接之前對齊。 join -keyword 與其他方法一樣工作。

>>> t = pd.Series(['d', 'a', 'e', 'c'], index=[3, 0, 4, 2])
>>> s.str.cat(t, join='left', na_rep='-')
0    aa
1    b-
2    -c
3    dd
dtype:object
>>>
>>> s.str.cat(t, join='outer', na_rep='-')
0    aa
1    b-
2    -c
3    dd
4    -e
dtype:object
>>>
>>> s.str.cat(t, join='inner', na_rep='-')
0    aa
2    -c
3    dd
dtype:object
>>>
>>> s.str.cat(t, join='right', na_rep='-')
3    dd
0    aa
4    -e
2    -c
dtype:object

有關更多示例，請參見此處。

相關用法

注：本文由純淨天空篩選整理自pandas.pydata.org大神的英文原創作品 pandas.Series.str.cat。非經特殊聲明，原始代碼版權歸原作者所有，本譯文未經允許或授權，請勿轉載或複製。

用法:

參數：

返回：

例子：