bigframes.pandas.api.typing.StringMethods.join#

StringMethods.join(sep: str) → T[source]#

Join lists contained as elements in the Series/Index with passed delimiter.

If the elements of a Series are lists themselves, join the content of these lists using the delimiter passed to the function. This function is an equivalent to str.join().

Examples:

>>> import bigframes.pandas as bpd

Example with a list that contains non-string elements.

>>> s = bpd.Series([['lion', 'elephant', 'zebra'],
...                ['dragon'],
...                ['duck', 'swan', 'fish', 'guppy']])
>>> s
0       ['lion' 'elephant' 'zebra']
1                        ['dragon']
2    ['duck' 'swan' 'fish' 'guppy']
dtype: list<item: string>[pyarrow]

>>> s.str.join('-')
0     lion-elephant-zebra
1                  dragon
2    duck-swan-fish-guppy
dtype: string

Parameters:

sep (str) Delimiter to use between list entries.

Returns:

The list entries concatenated by intervening occurrences of the delimiter.

Return type:

bigframes.series.Series