pandas.Index.putmask — pandas 3.0.0rc0+34.g04a554c9f1 documentation (original) (raw)

Index.putmask(mask, value)[source]#

Return a new Index of the values set with the mask.

Parameters:

maskarray-like of bool

Array of booleans denoting where values should be replaced.

valuescalar

Scalar value to use to fill holes (e.g. 0). This value cannot be a list-likes.

Returns:

Index

A new Index of the values set with the mask.

See also

numpy.putmask

Changes elements of an array based on conditional and input values.

Examples

idx1 = pd.Index([1, 2, 3]) idx2 = pd.Index([5, 6, 7]) idx1.putmask([True, False, False], idx2) Index([5, 2, 3], dtype='int64')