pandas.Series.to_string#

Series.to_string(buf=None, *, na_rep='NaN', float_format=None, header=True, index=True, length=False, dtype=False, name=False, max_rows=None, min_rows=None)[source]#

Render a string representation of the Series.

Parameters:
bufStringIO-like, optional

Buffer to write to.

na_repstr, optional

String representation of NaN to use, default ‘NaN’.

float_formatone-parameter function, optional

Formatter function to apply to columns’ elements if they are floats, default None.

headerbool, default True

Add the Series header (index name).

indexbool, optional

Add index (row) labels, default True.

lengthbool, default False

Add the Series length.

dtypebool, default False

Add the Series dtype.

namebool, default False

Add the Series name if not None.

max_rowsint, optional

Maximum number of rows to show before truncating. If None, show all.

min_rowsint, optional

The number of rows to display in a truncated repr (when number of rows is above max_rows).

Returns:
str or None

String representation of Series if buf=None, otherwise None.

See also

Series.to_dict

Convert Series to dict object.

Series.to_frame

Convert Series to DataFrame object.

Series.to_markdown

Print Series in Markdown-friendly format.

Series.to_timestamp

Cast to DatetimeIndex of Timestamps.

Examples

>>> ser = pd.Series([1, 2, 3]).to_string()
>>> ser
'0    1\n1    2\n2    3'