polars.Expr.item

Expr.item(
    *,
    allow_empty: bool = False,
) → Expr

Получить единственное значение.

движок:В памятиПотоковая обработкаРаспределенная обработка

Возникает ошибка, если значений не ровно одно.

Параметры:

allow_empty

Разрешить отсутствие значений, чтобы вернуть null.

См. также

Expr.get()

Получить одно значение по индексу.

Примеры

>>> df = pl.DataFrame({"a": [1]})
>>> df.select(pl.col("a").item())
shape: (1, 1)
┌─────┐
│ a   │
│ --- │
│ i64 │
╞═════╡
│ 1   │
└─────┘
>>> df = pl.DataFrame({"a": [1, 2, 3]})
>>> df.select(pl.col("a").item())
Traceback (most recent call last):
...
polars.exceptions.ComputeError: aggregation 'item' expected a single value, got 3 values
...
>>> df.head(0).select(pl.col("a").item(allow_empty=True))
shape: (1, 1)
┌──────┐
│ a    │
│ ---  │
│ i64  │
╞══════╡
│ null │
└──────┘