polars.int_ranges

polars.int_ranges(
    start: int | IntoExprColumn = 0,
    end: int | IntoExprColumn | None = None,
    step: int | IntoExprColumn = 1,
    *,
    dtype: PolarsIntegerType | DataTypeExpr = Int64,
    eager: bool = False,
) → Expr | Series

Создаёт диапазон целых чисел для каждой строки входных столбцов.

Параметры:

start

Начало диапазона (включительно). По умолчанию — 0.

end

Конец диапазона (не включительно). Если задано None (по умолчанию), используется значение start, а start устанавливается в 0.

step

Шаг диапазона.

dtype

Целочисленный тип данных диапазонов. По умолчанию — Int64.

eager

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

Возвращает:

Expr или Series

Столбец типа данных List(dtype).

См. также

int_range

Создаёт один диапазон целых чисел.

Примеры

>>> df = pl.DataFrame({"start": [1, -1], "end": [3, 2]})
>>> df.with_columns(int_range=pl.int_ranges("start", "end"))
shape: (2, 3)
┌───────┬─────┬────────────┐
│ start ┆ end ┆ int_range  │
│ ---   ┆ --- ┆ ---        │
│ i64   ┆ i64 ┆ list[i64]  │
╞═══════╪═════╪════════════╡
│ 1     ┆ 3   ┆ [1, 2]     │
│ -1    ┆ 2   ┆ [-1, 0, 1] │
└───────┴─────┴────────────┘

end можно опустить для более краткого синтаксиса.

>>> df.select("end", int_range=pl.int_ranges("end"))
shape: (2, 2)
┌─────┬───────────┐
│ end ┆ int_range │
│ --- ┆ ---       │
│ i64 ┆ list[i64] │
╞═════╪═══════════╡
│ 3   ┆ [0, 1, 2] │
│ 2   ┆ [0, 1]    │
└─────┴───────────┘