pandas.io.formats.style.Styler.to_string#

Styler.to_string(buf=None, *, encoding=None, sparse_index=None, sparse_columns=None, max_rows=None, max_columns=None, delimiter=' ')[源代码][源代码]#

以文本格式将样式器写入文件、缓冲区或字符串。

Added in version 1.5.0.

参数:

bufstr, 路径对象, 类文件对象, 可选

字符串、路径对象（实现 os.PathLike[str]），或实现字符串 write() 函数的类文件对象。如果为 None，结果将作为字符串返回。

编码str, 可选

文件输出（如果可用，还包括元标签）的字符编码设置。默认为 pandas.options.styler.render.encoding 值为 “utf-8”。

sparse_indexbool, 可选

是否简化层次索引的显示。设置为 False 将显示每一行中层次键的每个显式级别元素。默认为 pandas.options.styler.sparse.index 值。

sparse_columnsbool, 可选

是否稀疏显示分层索引。设置为 False 将显示每个列的分层键中每个显式级别元素。默认为 pandas.options.styler.sparse.columns 值。

max_rowsint, 可选

将渲染的最大行数。默认为 pandas.options.styler.render.max_rows，即 None。

max_columnsint, 可选

将呈现的最大列数。默认为 pandas.options.styler.render.max_columns，即 None。

如果元素总数很大，行和列可能会减少。此值设置为 pandas.options.styler.render.max_elements，即 262144（18 位浏览器渲染）。

分隔符str, 默认单个空格

数据元素之间的分隔符。

返回:

str 或 None: 如果 buf 是 None，则以字符串形式返回结果。否则返回 None。

示例

>>> df = pd.DataFrame({"A": [1, 2], "B": [3, 4]})
>>> df.style.to_string()
' A B\n0 1 3\n1 2 4\n'