pandas.arrays.BooleanArray#

class pandas.arrays.BooleanArray(values, mask, copy=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).

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.

Attributes

None

Methods

None

Returns:
BooleanArray

See also

array

Create an array from data with the appropriate dtype.

BooleanDtype

Extension dtype for boolean data.

Series

One-dimensional ndarray with axis labels (including time series).

DataFrame

Two-dimensional, size-mutable, potentially heterogeneous tabular data.

Examples

Create an BooleanArray with pandas.array():

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