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:
    dtypenp.dtype or None

      Specifies the the dtype for the array.

    copybool 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.

  Examples

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

  The following calls `cat.__array__`

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