W3cubDocs

/pandas 2

pandas.api.types.is_categorical_dtype

pandas.api.types.is_categorical_dtype(arr_or_dtype)[source]

Check whether an array-like or dtype is of the Categorical dtype.

Deprecated since version 2.2.0: Use isinstance(dtype, pd.CategoricalDtype) instead.

Parameters:
arr_or_dtype:array-like or dtype

The array-like or dtype to check.

Returns:
boolean

Whether or not the array-like or dtype is of the Categorical dtype.

Examples

>>> from pandas.api.types import is_categorical_dtype
>>> from pandas import CategoricalDtype
>>> is_categorical_dtype(object)
False
>>> is_categorical_dtype(CategoricalDtype())
True
>>> is_categorical_dtype([1, 2, 3])
False
>>> is_categorical_dtype(pd.Categorical([1, 2, 3]))
True
>>> is_categorical_dtype(pd.CategoricalIndex([1, 2, 3]))
True

© 2008–2011, AQR Capital Management, LLC, Lambda Foundry, Inc. and PyData Development Team
© 2011–2025, Open source contributors
Licensed under the 3-clause BSD License.
https://pandas.pydata.org/pandas-docs/version/2.3.0/reference/api/pandas.api.types.is_categorical_dtype.html