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)[source]

Вывод DataFrame в удобочитаемой табличной форме для консоли.

Parameters:

buf:str, Path или StringIO-подобный объект, необязательно, по умолчанию None

Буфер для записи. Если None, результат возвращается как строка.

columns:последовательность, необязательно, по умолчанию None

Подмножество столбцов для вывода. По умолчанию выводятся все столбцы.

col_space:int, список или словарь целых чисел, необязательно

Минимальная ширина каждого столбца. Если передаётся список целых чисел, каждое число соответствует одному столбцу. Если передаётся словарь, ключ — имя столбца, а значение — ширина.

header:bool или список строк, необязательно

Выводить имена столбцов. Если передан список, предполагается, что это псевдонимы имён столбцов.

index:bool, необязательно, по умолчанию True

Выводить метки строк (индексы).

na_rep:строка, необязательно, по умолчанию ‘NaN’

Строковое представление NaN для использования.

formatters:список, кортеж или словарь функций с одним параметром, необязательно

Функции форматирования для применения к элементам столбцов по позиции или имени. Результатом каждой функции должна быть строка Unicode.

float_format:функция с одним параметром, необязательно, по умолчанию None

Функция форматирования для применения к элементам столбцов, если они являются числами с плавающей точкой. Эта функция должна возвращать строку Unicode и будет применена только к не-NaN элементам, при этом NaN обрабатывается na_rep.

sparsify:bool, необязательно, по умолчанию True

Установите в False для DataFrame с иерархическим индексом, чтобы выводить каждый ключ многоуровневого индекса в каждой строке.

index_names:bool, необязательно, по умолчанию True

Выводить имена индексов.

justify:строка, по умолчанию None

Как выравнивать метки столбцов. Если None, используется опция из конфигурации вывода (управляемая set_option), по умолчанию ‘right’. Допустимые значения:

• left

• right

• center

• justify

• justify-all

• start

• end

• inherit

• match-parent

• initial

• unset.

max_rows:int, необязательно

Максимальное количество строк для отображения в консоли.

max_cols:int, необязательно

Максимальное количество столбцов для отображения в консоли.

show_dimensions:bool, по умолчанию False

Отображать размеры DataFrame (количество строк и столбцов).

decimal:строка, по умолчанию ‘.’

Символ, распознаваемый как десятичный разделитель, например ‘,’ в Европе.

line_width:int, необязательно

Ширина переноса строки в символах.

min_rows:int, необязательно

Количество строк для отображения в консоли в усечённом представлении (когда число строк больше max_rows).

max_colwidth:int, необязательно

Максимальная ширина усечения каждого столбца в символах. По умолчанию ограничений нет.

encoding:строка, по умолчанию “utf-8”

Настройка кодировки символов.

Returns:

строка или None

Если 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