polars.Series.replace

Series.replace(
    old: IntoExpr | Sequence[Any] | Mapping[Any,
    Any],
    new: IntoExpr | Sequence[Any] | NoDefault = <no_default>,
    *,
    default: IntoExpr | NoDefault = <no_default>,
    return_dtype: PolarsDataType | None = None,
) → Self

Заменяет значения другими значениями того же типа данных.

Параметры:

old

Значение или последовательность значений для замены. Также принимает отображение значений в значения для замены — это синтаксический сахар для replace(old=Series(mapping.keys()), new=Series(mapping.values())).

new

Значение или последовательность значений, на которые нужно заменить. Длина должна совпадать с длиной old или быть равна 1.

default

Устанавливает это значение для значений, которые не были заменены. По умолчанию исходные значения сохраняются. Принимает выражение. Входные данные, не являющиеся выражениями, интерпретируются как литералы.

Устарело с версии 0.20.31: Вместо этого используйте replace_strict(), чтобы задать значение по умолчанию при замене значений.

return_dtype

Тип данных результирующего выражения. Если задано None (по умолчанию), тип данных определяется автоматически на основе других входных данных.

Устарело с версии 0.20.31: Вместо этого используйте replace_strict(), чтобы задать тип данных результата при замене значений.

См. также

replace_strict

str.replace

Примеры

Замените одно значение другим. Значения, которые не были заменены, остаются без изменений.

>>> s = pl.Series([1, 2, 2, 3])
>>> s.replace(2, 100)
shape: (4,)
Series: '' [i64]
[
    1
    100
    100
    3
]

Замените несколько значений, передав последовательности в параметры old и new.

>>> s.replace([2, 3], [100, 200])
shape: (4,)
Series: '' [i64]
[
    1
    100
    100
    200
]

Также поддерживается передача отображения замен в качестве синтаксического сахара.

>>> mapping = {2: 100, 3: 200}
>>> s.replace(mapping)
shape: (4,)
Series: '' [i64]
[
    1
    100
    100
    200
]

При замене значениями другого типа данных исходный тип данных сохраняется. Используйте replace_strict(), чтобы выполнить замену и изменить тип данных результата.

>>> s = pl.Series(["x", "y", "z"])
>>> mapping = {"x": 1, "y": 2, "z": 3}
>>> s.replace(mapping)
shape: (3,)
Series: '' [str]
[
    "1"
    "2"
    "3"
]