pandas.arrays.BooleanArray

class pandas.arrays.BooleanArray(values: numpy.ndarray, mask: numpy.ndarray, copy: bool = False)[source]

Array of boolean (True/False) data with missing values.

This is a pandas Extension array for boolean data, under the hood represented by 2 numpy arrays: a boolean array with the data and a boolean array with the mask (True indicating missing).

BooleanArray implements Kleene logic (sometimes called three-value logic) for logical operations. See Kleene Logical Operations for more.

To construct an BooleanArray from generic array-like input, use pandas.array() specifying dtype="boolean" (see examples below).

New in version 1.0.0.

Warning

BooleanArray is considered experimental. The implementation and parts of the API may change without warning.

Parameters
valuesnumpy.ndarray

A 1-d boolean-dtype array with the data.

masknumpy.ndarray

A 1-d boolean-dtype array indicating missing values (True indicates missing).

copybool, default False

Whether to copy the values and mask arrays.

Returns
BooleanArray

Examples

Create an BooleanArray with pandas.array():

>>> pd.array([True, False, None], dtype="boolean")
<BooleanArray>
[True, False, <NA>]
Length: 3, dtype: boolean

Attributes

None

Methods

None