docstr: ivy.Container instance method variant of ivy.gather. This method
  simply wraps the function, and so the docstring for ivy.gather also
  applies to this method with minimal changes.
  
  Parameters
  ----------
  self
      The container from which to gather values.
  indices
      The container or array which indicates the indices that will be
      gathered along the specified axis.
  axis
      The axis from which the indices will be gathered. Default is ``-1``.
  batch_dims
      optional int, lets you gather different items from each element of a batch.
  key_chains
      The key-chains to apply or not apply the method to. Default is ``None``.
  to_apply
      If True, the method will be applied to key_chains, otherwise key_chains
      will be skipped. Default is ``True``.
  prune_unapplied
      Whether to prune key_chains for which the function was not applied.
      Default is ``False``.
  map_sequences
      Whether to also map method to sequences (lists, tuples). Default is
      False.
  out
      Optional array, for writing the result to. It must have a shape
      that the inputs broadcast to.
  
  Returns
  -------
  ret
      New container with the values gathered at the specified indices
      along the specified axis.
  
  Examples
  --------
  >>> x = ivy.Container(a = ivy.array([0., 1., 2.]),
  ...                   b = ivy.array([4., 5., 6.]))
  >>> y = ivy.Container(a = ivy.array([0, 1]),
  ...                   b = ivy.array([1, 2]))
  >>> z = x.gather(y)
  >>> print(z)
  {
      a: ivy.array([0., 1.]),
      b: ivy.array([5., 6.])
  }
docstr_tok: ["ivy.Container","instance","method","variant","of","ivy.gather",".","This","method","simply","wraps","the","function",",","and","so","the","docstring","for","ivy.gather","also","applies","to","this","method","with","minimal","changes",".","Parameters","--","--","--","--","--","self","The","container","from","which","to","gather","values",".","indices","The","container","or","array","which","indicates","the","indices","that","will","be","gathered","along","the","specified","axis",".","axis","The","axis","from","which","the","indices","will","be","gathered",".","Default","is","``","-1","``",".","batch_dims","optional","int",",","lets","you","gather","different","items","from","each","element","of","a","batch",".","key_chains","The","key-chains","to","apply","or","not","apply","the","method","to",".","Default","is","``","None","``",".","to_apply","If","True",",","the","method","will","be","applied","to","key_chains",",","otherwise","key_chains","will","be","skipped",".","Default","is","``","True","``",".","prune_unapplied","Whether","to","prune","key_chains","for","which","the","function","was","not","applied",".","Default","is","``","False","``",".","map_sequences","Whether","to","also","map","method","to","sequences","(","lists",",","tuples",")",".","Default","is","False",".","out","Optional","array",",","for","writing","the","result","to",".","It","must","have","a","shape","that","the","inputs","broadcast","to",".","Returns","--","--","--","-","ret","New","container","with","the","values","gathered","at","the","specified","indices","along","the","specified","axis",".","Examples","--","--","--","--",">",">",">","x","=","ivy.Container","(","a","=","ivy.array","(","[","0.",",","1.",",","2",".","]",")",",","...","b","=","ivy.array","(","[","4.",",","5.",",","6",".","]",")",")",">",">",">","y","=","ivy.Container","(","a","=","ivy.array","(","[","0",",","1","]",")",",","...","b","=","ivy.array","(","[","1",",","2","]",")",")",">",">",">","z","=","x.gather","(","y",")",">",">",">","print","(","z",")","{","a",":","ivy.array","(","[","0.",",","1",".","]",")",",","b",":","ivy.array","(","[","5.",",","6",".","]",")","}"]
code: def gather(
      self: ivy.Container,
      indices: Union[ivy.Container, ivy.Array, ivy.NativeArray],
      /,
      *,
      axis: Union[int, ivy.Container] = -1,
      batch_dims: Union[int, ivy.Container] = 0,
      key_chains: Optional[
          Union[List[str], Dict[str, str], ivy.Container]
      ] = None,
      to_apply: Union[bool, ivy.Container] = True,
      prune_unapplied: Union[bool, ivy.Container] = False,
      map_sequences: Union[bool, ivy.Container] = False,
      out: Optional[ivy.Container] = None,
  ) -> ivy.Container:
      """ivy.Container instance method variant of ivy.gather. This method
      simply wraps the function, and so the docstring for ivy.gather also
      applies to this method with minimal changes.
  
      Parameters
      ----------
      self
          The container from which to gather values.
      indices
          The container or array which indicates the indices that will be
          gathered along the specified axis.
      axis
          The axis from which the indices will be gathered. Default is ``-1``.
      batch_dims
          optional int, lets you gather different items from each element of a batch.
      key_chains
          The key-chains to apply or not apply the method to. Default is ``None``.
      to_apply
          If True, the method will be applied to key_chains, otherwise key_chains
          will be skipped. Default is ``True``.
      prune_unapplied
          Whether to prune key_chains for which the function was not applied.
          Default is ``False``.
      map_sequences
          Whether to also map method to sequences (lists, tuples). Default is
          False.
      out
          Optional array, for writing the result to. It must have a shape
          that the inputs broadcast to.
  
      Returns
      -------
      ret
          New container with the values gathered at the specified indices
          along the specified axis.
  
      Examples
      --------
      >>> x = ivy.Container(a = ivy.array([0., 1., 2.]),
      ...                   b = ivy.array([4., 5., 6.]))
      >>> y = ivy.Container(a = ivy.array([0, 1]),
      ...                   b = ivy.array([1, 2]))
      >>> z = x.gather(y)
      >>> print(z)
      {
          a: ivy.array([0., 1.]),
          b: ivy.array([5., 6.])
      }
      """
      return self._static_gather(
          self,
          indices,
          axis=axis,
          batch_dims=batch_dims,
          key_chains=key_chains,
          to_apply=to_apply,
          prune_unapplied=prune_unapplied,
          map_sequences=map_sequences,
          out=out,
      )
  
imports: from numbers import Number
  from typing import Any, Union, List, Dict, Iterable, Optional, Callable
  from ivy.data_classes.container.base import ContainerBase
  import ivy
label_desc: Use image node_id 22 for calling the _ContainerWithGeneral obj's underlying member method code with example usage: obj.gather() and returns: self