class_docstr: Index based on an underlying :class:`Categorical`.
  
  CategoricalIndex, like Categorical, can only take on a limited,
  and usually fixed, number of possible values (`categories`). Also,
  like Categorical, it might have an order, but numerical operations
  (additions, divisions, ...) are not possible.
  
  Parameters
  ----------
  data : array-like (1-dimensional)
      The values of the categorical. If `categories` are given, values not in
      `categories` will be replaced with NaN.
  categories : index-like, optional
      The categories for the categorical. Items need to be unique.
      If the categories are not given here (and also not in `dtype`), they
      will be inferred from the `data`.
  ordered : bool, optional
      Whether or not this categorical is treated as an ordered
      categorical. If not given here or in `dtype`, the resulting
      categorical will be unordered.
  dtype : CategoricalDtype or "category", optional
      If :class:`CategoricalDtype`, cannot be used together with
      `categories` or `ordered`.
  copy : bool, default False
      Make a copy of input ndarray.
  name : object, optional
      Name to be stored in the index.
  
  Attributes
  ----------
  codes
  categories
  ordered
  
  Methods
  -------
  rename_categories
  reorder_categories
  add_categories
  remove_categories
  remove_unused_categories
  set_categories
  as_ordered
  as_unordered
  map
  
  Raises
  ------
  ValueError
      If the categories do not validate.
  TypeError
      If an explicit ``ordered=True`` is given but no `categories` and the
      `values` are not sortable.
  
  See Also
  --------
  Index : The base pandas Index type.
  Categorical : A categorical array.
  CategoricalDtype : Type for categorical data.
  
  Notes
  -----
  See the `user guide
  <https://pandas.pydata.org/pandas-docs/stable/user_guide/advanced.html#categoricalindex>`__
  for more.
  
  Examples
  --------
  >>> pd.CategoricalIndex(["a", "b", "c", "a", "b", "c"])
  CategoricalIndex(['a', 'b', 'c', 'a', 'b', 'c'],
                   categories=['a', 'b', 'c'], ordered=False, dtype='category')
  
  ``CategoricalIndex`` can also be instantiated from a ``Categorical``:
  
  >>> c = pd.Categorical(["a", "b", "c", "a", "b", "c"])
  >>> pd.CategoricalIndex(c)
  CategoricalIndex(['a', 'b', 'c', 'a', 'b', 'c'],
                   categories=['a', 'b', 'c'], ordered=False, dtype='category')
  
  Ordered ``CategoricalIndex`` can have a min and max value.
  
  >>> ci = pd.CategoricalIndex(
  ...     ["a", "b", "c", "a", "b", "c"], ordered=True, categories=["c", "b", "a"]
  ... )
  >>> ci
  CategoricalIndex(['a', 'b', 'c', 'a', 'b', 'c'],
                   categories=['c', 'b', 'a'], ordered=True, dtype='category')
  >>> ci.min()
  'c'
class_docstr_tok: ["Index","based","on","an","underlying",":","class",":","`","Categorical","`",".","CategoricalIndex",",","like","Categorical",",","can","only","take","on","a","limited",",","and","usually","fixed",",","number","of","possible","values","(","`","categories","`",")",".","Also",",","like","Categorical",",","it","might","have","an","order",",","but","numerical","operations","(","additions",",","divisions",",","...",")","are","not","possible",".","Parameters","--","--","--","--","--","data",":","array-like","(","1-dimensional",")","The","values","of","the","categorical",".","If","`","categories","`","are","given",",","values","not","in","`","categories","`","will","be","replaced","with","NaN",".","categories",":","index-like",",","optional","The","categories","for","the","categorical",".","Items","need","to","be","unique",".","If","the","categories","are","not","given","here","(","and","also","not","in","`","dtype","`",")",",","they","will","be","inferred","from","the","`","data","`",".","ordered",":","bool",",","optional","Whether","or","not","this","categorical","is","treated","as","an","ordered","categorical",".","If","not","given","here","or","in","`","dtype","`",",","the","resulting","categorical","will","be","unordered",".","dtype",":","CategoricalDtype","or","``","category","''",",","optional","If",":","class",":","`","CategoricalDtype","`",",","can","not","be","used","together","with","`","categories","`","or","`","ordered","`",".","copy",":","bool",",","default","False","Make","a","copy","of","input","ndarray",".","name",":","object",",","optional","Name","to","be","stored","in","the","index",".","Attributes","--","--","--","--","--","codes","categories","ordered","Methods","--","--","--","-","rename_categories","reorder_categories","add_categories","remove_categories","remove_unused_categories","set_categories","as_ordered","as_unordered","map","Raises","--","--","--","ValueError","If","the","categories","do","not","validate",".","TypeError","If","an","explicit","``","ordered=True","``","is","given","but","no","`","categories","`","and","the","`","values","`","are","not","sortable",".","See","Also","--","--","--","--","Index",":","The","base","pandas","Index","type",".","Categorical",":","A","categorical","array",".","CategoricalDtype",":","Type","for","categorical","data",".","Notes","--","--","-","See","the","`","user","guide","<","https",":","\/\/pandas.pydata.org\/pandas-docs\/stable\/user_guide\/advanced.html","#","categoricalindex",">","`","__","for","more",".","Examples","--","--","--","--",">",">",">","pd.CategoricalIndex","(","[","``","a","''",",","``","b","''",",","``","c","''",",","``","a","''",",","``","b","''",",","``","c","''","]",")","CategoricalIndex","(","[","'","a","'",",","'","b","'",",","'","c","'",",","'","a","'",",","'","b","'",",","'","c","'","]",",","categories=","[","'","a","'",",","'","b","'",",","'","c","'","]",",","ordered=False",",","dtype='category","'",")","``","CategoricalIndex","``","can","also","be","instantiated","from","a","``","Categorical","``",":",">",">",">","c","=","pd.Categorical","(","[","``","a","''",",","``","b","''",",","``","c","''",",","``","a","''",",","``","b","''",",","``","c","''","]",")",">",">",">","pd.CategoricalIndex","(","c",")","CategoricalIndex","(","[","'","a","'",",","'","b","'",",","'","c","'",",","'","a","'",",","'","b","'",",","'","c","'","]",",","categories=","[","'","a","'",",","'","b","'",",","'","c","'","]",",","ordered=False",",","dtype='category","'",")","Ordered","``","CategoricalIndex","``","can","have","a","min","and","max","value",".",">",">",">","ci","=","pd.CategoricalIndex","(","...","[","``","a","''",",","``","b","''",",","``","c","''",",","``","a","''",",","``","b","''",",","``","c","''","]",",","ordered=True",",","categories=","[","``","c","''",",","``","b","''",",","``","a","''","]","...",")",">",">",">","ci","CategoricalIndex","(","[","'","a","'",",","'","b","'",",","'","c","'",",","'","a","'",",","'","b","'",",","'","c","'","]",",","categories=","[","'","c","'",",","'","b","'",",","'","a","'","]",",","ordered=True",",","dtype='category","'",")",">",">",">","ci.min","(",")","'","c","'"]
docstr: Create index with target's values (move/add/delete values as necessary)
  
  Returns
  -------
  new_index : pd.Index
      Resulting index
  indexer : np.ndarray[np.intp] or None
      Indices of output values in original index
docstr_tok: ["Create","index","with","target","'s","values","(","move\/add\/delete","values","as","necessary",")","Returns","--","--","--","-","new_index",":","pd.Index","Resulting","index","indexer",":","np.ndarray","[","np.intp","]","or","None","Indices","of","output","values","in","original","index"]
code: def reindex(
      self,
      target,
      method=None,
      level=None,
      limit: int | None = None,
      tolerance=None,
  ) -> tuple[Index, npt.NDArray[np.intp] | None]:
      """
      Create index with target's values (move/add/delete values as necessary)
  
      Returns
      -------
      new_index : pd.Index
          Resulting index
      indexer : np.ndarray[np.intp] or None
          Indices of output values in original index
  
      """
      if method is not None:
          raise NotImplementedError(
              "argument method is not implemented for CategoricalIndex.reindex"
          )
      if level is not None:
          raise NotImplementedError(
              "argument level is not implemented for CategoricalIndex.reindex"
          )
      if limit is not None:
          raise NotImplementedError(
              "argument limit is not implemented for CategoricalIndex.reindex"
          )
      return super().reindex(target)
  
imports: from __future__ import annotations
  from typing import TYPE_CHECKING, Any, Literal, cast
  import numpy
  from pandas._libs import index
  from pandas.util._decorators import cache_readonly, doc
  from pandas.core.dtypes.common import is_scalar
  from pandas.core.dtypes.concat import concat_compat
  from pandas.core.dtypes.dtypes import CategoricalDtype
  from pandas.core.dtypes.missing import is_valid_na_for_dtype, isna
  from pandas.core.arrays.categorical import Categorical, contains
  from pandas.core.construction import extract_array
  from pandas.core.indexes.base import Index, maybe_extract_name
  from pandas.core.indexes.extension import NDArrayBackedExtensionIndex, inherit_names
label_desc: Use image node_id 11 for calling the CategoricalIndex obj's underlying member method code with example usage: obj.reindex(target, method, level, limit, tolerance) and returns: super