polars.Expr.extend_constant#

Expr.extend_constant(value: PythonLiteral | None, n: int) → Self[source]#

Extremely fast method for extending the Series with ‘n’ copies of a value.

Parameters:

value: A constant literal value (not an expression) with which to extend the expression result Series; can pass None to extend with nulls.
n: The number of additional values that will be added.

Examples

>>> df = pl.DataFrame({"values": [1, 2, 3]})
>>> df.select((pl.col("values") - 1).extend_constant(99, n=2))
shape: (5, 1)
┌────────┐
│ values │
│ ---    │
│ i64    │
╞════════╡
│ 0      │
│ 1      │
│ 2      │
│ 99     │
│ 99     │
└────────┘