pandas.DataFrame.to_string#
- DataFrame.to_string(buf=None, columns=None, col_space=None, header=True, index=True, na_rep='NaN', formatters=None, float_format=None, sparsify=None, index_names=True, justify=None, max_rows=None, max_cols=None, show_dimensions=False, decimal='.', line_width=None, min_rows=None, max_colwidth=None, encoding=None)[源代码]#
将DataFrame呈现为控制台友好的表格输出。
- 参数
- buf字符串、路径或类似StringIO、可选、默认无
要写入的缓冲区。如果无,则以字符串形式返回输出。
- columns序列,可选,默认为无
要写入的列子集。默认情况下写入所有列。
- col_spaceInt、list或dict of int,可选
每列的最小宽度。如果给定一个整数列表,则每个整数对应一列。如果给定了字典,则键引用该列,而值则定义要使用的空间。
- headerBool或字符串序列,可选
写出列名。如果给出了一个字符串列表,则假定它是列名的别名。
- index布尔值,可选,默认为True
是否打印索引(行)标签。
- na_rep字符串,可选,缺省为‘NaN’
的字符串表示形式
NaN
来使用。- formatters单参数的列表、元组或字典。函数,可选
格式化程序的功能是按位置或名称应用于列元素。每个函数的结果必须是Unicode字符串。列表/元组的长度必须等于列数。
- float_format单参数函数,可选,默认为无
如果列的元素是浮点数,则使用格式化程序函数将其应用于列的元素。此函数必须返回Unicode字符串,并且将仅应用于非``NaN``元素,
NaN
由以下人员处理na_rep
。在 1.2.0 版更改.
- sparsify布尔值,可选,默认为True
对于具有分层索引的DataFrame,设置为False以打印每行的每个多索引键。
- index_names布尔值,可选,默认为True
打印索引的名称。
- justify字符串,默认为无
如何对齐列标签。如果没有使用打印配置中的选项(由SET_OPTION控制),则“right”开箱即用。有效值为
左边
正确的
居中
理据
对齐-全部
开始
结束
继承
匹配-父项
首字母
取消设置。
- max_rows整型,可选
控制台中显示的最大行数。
- max_cols整型,可选
控制台中显示的最大列数。
- show_dimensions布尔值,默认为False
显示DataFrame维(按列数显示行数)。
- decimal字符串,默认为‘.’
识别为小数分隔符的字符,例如欧洲的‘,’。
- line_width整型,可选
Width用于在字符中换行。
- min_rows整型,可选
在截断的REPR中显示在控制台中的行数(当行数在上面时 max_rows )。
- max_colwidth整型,可选
以字符为单位截断每列的最大宽度。默认情况下,没有限制。
1.0.0 新版功能.
- encoding字符串,默认“utf-8”
设置字符编码。
1.0 新版功能.
- 退货
- 字符串或无
如果buf为NONE,则以字符串形式返回结果。否则返回None。
参见
to_html
将DataFrame转换为HTML。
示例
>>> 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