Skip to main content
`Ctrl`+`K`

# pandas.Categorical.codes

property Categorical.codes

  The category codes of this categorical index.

  Codes are an array of integers which are the positions of the actual values in the categories array.

  There is no setter, use the other categorical methods and the normal item setter to change values in the categorical.

  Returns:
    ndarray[int]

      A non-writable view of the `codes` array.

  Examples

  For `pandas.Categorical`:

      >>> cat = pd.Categorical(['a', 'b'], ordered=True)
      >>> cat.codes
      array([0, 1], dtype=int8)

  For `pandas.CategoricalIndex`:

      >>> ci = pd.CategoricalIndex(['a', 'b', 'c', 'a', 'b', 'c'])
      >>> ci.codes
      array([0, 1, 2, 0, 1, 2], dtype=int8)

      >>> ci = pd.CategoricalIndex(['a', 'c'], categories=['c', 'b', 'a'])
      >>> ci.codes
      array([2, 0], dtype=int8)