polars.coalesce

polars.coalesce(
    exprs: IntoExpr | Iterable[IntoExpr],
    *more_exprs: IntoExpr,
    eager: bool = False,
) → Expr | Series

Объединяет столбцы слева направо, сохраняя первое ненулевое значение.

Параметры:

exprs

Столбцы для объединения. Принимает выражение. Строки интерпретируются как имена столбцов, другие входные данные, не являющиеся выражениями, — как литералы.

*more_exprs

Дополнительные столбцы для объединения, передаваемые в виде позиционных аргументов.

eager

Немедленно вычисляет результат и возвращает Series; для этого требуется, чтобы хотя бы один из переданных аргументов был Series. Если задано значение False (по умолчанию), вместо этого возвращается выражение.

Примеры

>>> df = pl.DataFrame(
...     {
...         "a": [1, None, None, None],
...         "b": [1, 2, None, None],
...         "c": [5, None, 3, None],
...     }
... )

>>> df.with_columns(pl.coalesce("a", "b", "c", 10).alias("d"))
shape: (4, 4)
┌──────┬──────┬──────┬─────┐
│ a    ┆ b    ┆ c    ┆ d   │
│ ---  ┆ ---  ┆ ---  ┆ --- │
│ i64  ┆ i64  ┆ i64  ┆ i64 │
╞══════╪══════╪══════╪═════╡
│ 1    ┆ 1    ┆ 5    ┆ 1   │
│ null ┆ 2    ┆ null ┆ 2   │
│ null ┆ null ┆ 3    ┆ 3   │
│ null ┆ null ┆ null ┆ 10  │
└──────┴──────┴──────┴─────┘

>>> df.with_columns(pl.coalesce(pl.col(["a", "b", "c"]), 10.0).alias("d"))
shape: (4, 4)
┌──────┬──────┬──────┬──────┐
│ a    ┆ b    ┆ c    ┆ d    │
│ ---  ┆ ---  ┆ ---  ┆ ---  │
│ i64  ┆ i64  ┆ i64  ┆ f64  │
╞══════╪══════╪══════╪══════╡
│ 1    ┆ 1    ┆ 5    ┆ 1.0  │
│ null ┆ 2    ┆ null ┆ 2.0  │
│ null ┆ null ┆ 3    ┆ 3.0  │
│ null ┆ null ┆ null ┆ 10.0 │
└──────┴──────┴──────┴──────┘

>>> s1 = pl.Series("a", [None, 2, None])
>>> s2 = pl.Series("b", [1, None, 3])
>>> pl.coalesce(s1, s2, eager=True)
shape: (3,)
Series: 'a' [i64]
[
    1
    2
    3
]