`DataFrame.to_string()` / `Series.to_string()`

Метод to_string() возвращает текстовое представление DataFrame или Series. В отличие от print(df), он не сокращает таблицу при больших размерах и позволяет тонко настроить формат — удобно для вывода в логи или отчёты.

Сигнатура

DataFrame.to_string(buf=None, columns=None, col_space=None,
                    header=True, index=True, na_rep="NaN",
                    float_format=None, max_rows=None, max_cols=None,
                    line_width=None, justify=None)

Параметры

columns — список выводимых столбцов.
header / index — включать ли заголовок и индекс.
na_rep — замена для NaN.
float_format — функция или строка форматирования чисел.
max_rows / max_cols — лимиты вывода.
justify — выравнивание заголовков ("left", "right", "center").

Возвращаемое значение

str.

Примеры

Пример 1. Базовое использование

import pandas as pd

df = pd.DataFrame({"pin": ["A0", "A1"], "value": [512, 600]})
print(df.to_string())

  pin  value
0  A0    512
1  A1    600

Пример 2. Без индекса

import pandas as pd

df = pd.DataFrame({"x": [1, 2], "y": [3, 4]})
print(df.to_string(index=False))

x  y
1  3
2  4

Пример 3. Форматирование float

import pandas as pd

df = pd.DataFrame({"voltage": [3.30021, 5.00045, 12.0078]})
print(df.to_string(float_format="{:.2f}".format))

   voltage
   3.30
   5.00
  12.01

Пример 4. Только выбранные столбцы

import pandas as pd

df = pd.DataFrame({"a": [1, 2], "b": [3, 4], "c": [5, 6]})
print(df.to_string(columns=["a", "c"]))

   a  c
0  1  5
1  2  6

Пример 5. Замена NaN

import pandas as pd
import numpy as np

df = pd.DataFrame({"v": [1.0, np.nan, 3.0]})
print(df.to_string(na_rep="-"))

    v
1.0
  -
3.0

См. также

Примечание

Лицензия и источники

Техническое описание функции адаптировано из официальной документации Pandas (https://pandas.pydata.org/docs/), BSD-3-Clause License. Примеры и пояснения — © AlashEd Wiki.