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 в табличной форме, удобной для консольного вывода.

Параметры

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

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

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

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

col_space:int, список или словарь целых чисел, по умолчанию None

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

header:bool или последовательность строк, по умолчанию True

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

index:bool, по умолчанию True

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

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

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

formatters:список, кортеж или словарь функций с одним параметром, по умолчанию None

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

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

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

Изменено в версии 1.2.0.

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, по умолчанию None

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

max_cols:int, по умолчанию None

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

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

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

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

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

line_width:int, по умолчанию None

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

min_rows:int, по умолчанию None

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

max_colwidth:int, по умолчанию None

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

Добавлено в версии 1.0.0.

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

Установить кодировку символов.

Добавлено в версии 1.0.

Возвращает

str или 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