pandas.DataFrame.to_string#

DataFrame.to_string(buf=None, *, столбцы=None, col_space=None, header=True, index=True, na_rep='NaN', форматеры=None, float_format=None, разрежать=None, index_names=True, justify=None, max_rows=None, max_cols=None, show_dimensions=False, десятичный='.', line_width=None, min_rows=None, max_colwidth=None, кодировка=None)[источник]#

Отобразить DataFrame в табличном формате, удобном для консоли.

Параметры:

bufstr, Path или StringIO-like, опционально, по умолчанию None

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

столбцыподобный массиву, опционально, по умолчанию None

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

col_spaceint, список или словарь int, опционально

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

headerbool или список str, опционально

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

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

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

na_repstr, опционально, по умолчанию ‘NaN’

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

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

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

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

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

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

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

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

Выводит названия индексов.

justifystr, по умолчанию None

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

left
правый
центр
justify
justify-all
начало
end
наследовать
match-parent
начальный
не установлен.

max_rowsint, необязательный

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

max_colsint, необязательный

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

show_dimensionsbool, по умолчанию False

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

десятичныйstr, default ‘.’

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

line_widthint, необязательный

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

min_rowsint, необязательный

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

max_colwidthint, необязательный

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

кодировкаstr, по умолчанию "utf-8"

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

Возвращает:

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