polars.Expr.list.any#

Expr.list.any(*, ignore_nulls: bool = True) Expr[source]#

Evaluate whether any boolean value in a list is true.

Parameters:
ignore_nulls
  • If set to True (default), null values are ignored. If there are no non-null values, the output is False.

  • If set to False, Kleene logic is used to deal with nulls: if the column contains any null values and no True values, the output is null.

Examples

>>> df = pl.DataFrame(
...     {"a": [[True, True], [False, True], [False, False], [None], [], None]}
... )
>>> df.with_columns(any=pl.col("a").list.any())
shape: (6, 2)
┌────────────────┬───────┐
│ a              ┆ any   │
│ ---            ┆ ---   │
│ list[bool]     ┆ bool  │
╞════════════════╪═══════╡
│ [true, true]   ┆ true  │
│ [false, true]  ┆ true  │
│ [false, false] ┆ false │
│ [null]         ┆ false │
│ []             ┆ false │
│ null           ┆ null  │
└────────────────┴───────┘