Skip to main content
`Ctrl`+`K`

# pandas.Categorical.__array__

Categorical.__array__(dtype=None, copy=None)

  The numpy array interface.

  Users should not call this directly. Rather, it is invoked by `numpy.array()` and `numpy.asarray()`.

  Parameters:
    dtype np.dtype or None

      Specifies the dtype for the array.

    copy bool or None, optional

      See `numpy.asarray()`.

  Returns:
    numpy.array

      A numpy array of either the specified dtype or, if dtype==None (default), the same dtype as categorical.categories.dtype.

  See also

  `numpy.asarray`

    Convert input to numpy.ndarray.

  Examples

      >>> cat = pd.Categorical(["a", "b"], ordered=True)

  The following calls `cat.__array__`

      >>> np.asarray(cat)
      array(['a', 'b'], dtype=object)