Skip to main content
`Ctrl`+`K`

# 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)

  Render a string representation of the Series.

  Produces a human-readable text format of the Series, including optional display of the index, data types, name, and length. The output can be written to a buffer or returned as a string.

  Parameters:
    buf StringIO-like, optional

      Buffer to write to.

    na_rep str, default ‘NaN’

      String representation of NaN to use.

    float_format one-parameter function, optional

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

    header bool, default True

      Add the Series header (index name).

    index bool, default True

      Add index (row) labels.

    length bool, default False

      Add the Series length.

    dtype bool, default False

      Add the Series dtype.

    name bool, default False

      Add the Series name if not None.

    max_rows int, optional

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

    min_rows int, 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'