当前位置: 首页>>代码示例>>用法及示例精选>>正文


python pandas DataFrame.to_string用法及代码示例

用法:

DataFrame.to_string(self, buf:Union[str, pathlib.Path, IO[str], NoneType] = None, columns:Union[Sequence[str], NoneType] = None, col_space:Union[int, NoneType] = None, header:Union[bool, Sequence[str]] = True, index:bool = True, na_rep:str = 'NaN', formatters:Union[List[Callable], Tuple[Callable, ...], Mapping[Union[str, int], Callable], NoneType] = None, float_format:Union[str, Callable, ForwardRef('EngFormatter'), NoneType] = None, sparsify:Union[bool, NoneType] = None, index_names:bool = True, justify:Union[str, NoneType] = None, max_rows:Union[int, NoneType] = None, min_rows:Union[int, NoneType] = None, max_cols:Union[int, NoneType] = None, show_dimensions:bool = False, decimal:str = '.', line_width:Union[int, NoneType] = None, max_colwidth:Union[int, NoneType] = None, encoding:Union[str, NoneType] = None) → Union[str, NoneType]

将DataFrame渲染到控制台友好的表格输出。

参数:

bufstr, Path 或 StringIO-like, optional, 默认为 None

要写入的缓冲区。如果为None,则输出以字符串形式返回。

columnssequence, optional, 默认为 None

要写入的列的子集。默认情况下写入所有列。

col_spaceint, 可选参数

每列的最小宽度。

headerbool 或 sequence, 可选参数

写出列名。如果给出了字符串列表,则假定它是列名的别名。

indexbool, optional, 默认为 True

是否打印索引(行)标签。

na_repstr, optional, 默认为 ‘NaN’

要使用的NAN的字符串表示形式。

formatterslist, tuple 或 dict of one-param. functions, 可选参数

格式化程序功能可按位置或名称应用于列的元素。每个函数的结果必须是一个unicode字符串。列表/元组的长度必须等于列数。

float_formatone-parameter function, optional, 默认为 None

格式化程序功能应用于列的元素(如果它们是浮点型)。此函数的结果必须是unicode字符串。

sparsifybool, optional, 默认为 True

对于具有层次结构索引的DataFrame设置为False,以在每一行打印每个多索引键。

index_namesbool, optional, 默认为 True

打印索引名称。

justifystr, 默认为 None

如何对齐列标签。如果“无”使用打印配置中的选项(由set_option控制),则开箱即用‘right’。有效值为

  • left

  • right

  • center

  • justify

  • justify-all

  • start

  • end

  • inherit

  • match-parent

  • initial

  • 未设定。

max_rowsint, 可选参数

控制台中要显示的最大行数。

min_rowsint, 可选参数

要在控制台中以截短的repr显示的行数(当行数大于max_rows)。

max_colsint, 可选参数

控制台中要显示的最大列数。

show_dimensionsbool, 默认为 False

显示DataFrame的尺寸(行数乘以列数)。

decimalstr, 默认为 ‘.’

识别为小数点分隔符的字符,例如',' 在欧洲。

line_widthint, 可选参数

以字符换行的宽度。

max_colwidthint, 可选参数

截断每列字符的最大宽度。默认情况下,没有限制。

1.0.0版的新功能。

encodingstr, 默认为 “utf-8”

设置字符编码。

1.0版中的新功能。

返回值:

str

如果buf为None,则将结果作为字符串返回。否则返回None。

例子:

>>> d = {'col1': [1, 2, 3], 'col2': [4, 5, 6]}
>>> df = pd.DataFrame(d)
>>> print(df.to_string())
   col1  col2
0     1     4
1     2     5
2     3     6

源码:

pandas.DataFrame.to_string的API实现见:[源代码]

注:本文由纯净天空筛选整理自 pandas.DataFrame.to_string。非经特殊声明,原始代码版权归原作者所有,本译文的传播和使用请遵循“署名-相同方式共享 4.0 国际 (CC BY-SA 4.0)”协议。