polars.repeat#

polars.repeat(
value: IntoExpr | None,
n: int | Expr,
*,
dtype: PolarsDataType | None = None,
eager: Literal[False] = False,
name: str | None = None,
) Expr[source]#
polars.repeat(
value: IntoExpr | None,
n: int | Expr,
*,
dtype: PolarsDataType | None = None,
eager: Literal[True],
name: str | None = None,
) Series
polars.repeat(
value: IntoExpr | None,
n: int | Expr,
*,
dtype: PolarsDataType | None = None,
eager: bool,
name: str | None = None,
) Expr | Series

Construct a column of length n filled with the given value.

Parameters:
value

Value to repeat.

n

Length of the resulting column.

dtype

Data type of the resulting column. If set to None (default), data type is inferred from the given value. Defaults to Int32 for integer values, unless Int64 is required to fit the given value. Defaults to Float64 for float values.

eager

Evaluate immediately and return a Series. If set to False (default), return an expression instead.

name

Name of the resulting column.

Deprecated since version 0.17.15: This argument is deprecated. Use the alias method instead.

See also

lit

Notes

If you want to construct a column in lazy mode and do not need a pre-determined length, use lit() instead.

Examples

Construct a column with a repeated value in a lazy context.

>>> pl.select(pl.repeat("z", n=3)).to_series()
shape: (3,)
Series: 'repeat' [str]
[
        "z"
        "z"
        "z"
]

Generate a Series directly by setting eager=True.

>>> pl.repeat(3, n=3, dtype=pl.Int8, eager=True)
shape: (3,)
Series: 'repeat' [i8]
[
        3
        3
        3
]