docstr: ivy.Container instance method variant of ivy.where. This method
  simply wraps the function, and so the docstring for ivy.where also
  applies to this method with minimal changes.
  
  Parameters
  ----------
  self
      input array or container. Should have a boolean data type.
  x1
      input array or container. Should have a numeric data type.
  x2
      input array or container. Should have a numeric data type.
  out
      optional output container, for writing the result to. It must have a shape
      that the inputs broadcast to.
  
  Returns
  -------
  ret
      a container containing the values of x1 where condition is True, and x2
      where condition is False.
  
  Examples
  --------
  >>> x1 = ivy.Container(a=ivy.array([3, 1, 5]), b=ivy.array([2, 4, 6]))
  >>> x2 = ivy.Container(a=ivy.array([0, 7, 2]), b=ivy.array([3, 8, 5]))
  >>> res = x1.where((x1.a > x2.a), x2)
  >>> print(res)
  {
      a: ivy.array([1, 0, 1]),
      b: ivy.array([1, 0, 1])
  }
docstr_tok: ["ivy.Container","instance","method","variant","of","ivy.where",".","This","method","simply","wraps","the","function",",","and","so","the","docstring","for","ivy.where","also","applies","to","this","method","with","minimal","changes",".","Parameters","--","--","--","--","--","self","input","array","or","container",".","Should","have","a","boolean","data","type",".","x1","input","array","or","container",".","Should","have","a","numeric","data","type",".","x2","input","array","or","container",".","Should","have","a","numeric","data","type",".","out","optional","output","container",",","for","writing","the","result","to",".","It","must","have","a","shape","that","the","inputs","broadcast","to",".","Returns","--","--","--","-","ret","a","container","containing","the","values","of","x1","where","condition","is","True",",","and","x2","where","condition","is","False",".","Examples","--","--","--","--",">",">",">","x1","=","ivy.Container","(","a=ivy.array","(","[","3",",","1",",","5","]",")",",","b=ivy.array","(","[","2",",","4",",","6","]",")",")",">",">",">","x2","=","ivy.Container","(","a=ivy.array","(","[","0",",","7",",","2","]",")",",","b=ivy.array","(","[","3",",","8",",","5","]",")",")",">",">",">","res","=","x1.where","(","(","x1.a",">","x2.a",")",",","x2",")",">",">",">","print","(","res",")","{","a",":","ivy.array","(","[","1",",","0",",","1","]",")",",","b",":","ivy.array","(","[","1",",","0",",","1","]",")","}"]
code: def where(
      self: ivy.Container,
      x1: Union[ivy.Container, ivy.Array, ivy.NativeArray],
      x2: Union[ivy.Container, ivy.Array, ivy.NativeArray],
      /,
      *,
      out: Optional[ivy.Container] = None,
  ) -> ivy.Container:
      """ivy.Container instance method variant of ivy.where. This method
      simply wraps the function, and so the docstring for ivy.where also
      applies to this method with minimal changes.
  
      Parameters
      ----------
      self
          input array or container. Should have a boolean data type.
      x1
          input array or container. Should have a numeric data type.
      x2
          input array or container. Should have a numeric data type.
      out
          optional output container, for writing the result to. It must have a shape
          that the inputs broadcast to.
  
      Returns
      -------
      ret
          a container containing the values of x1 where condition is True, and x2
          where condition is False.
  
      Examples
      --------
      >>> x1 = ivy.Container(a=ivy.array([3, 1, 5]), b=ivy.array([2, 4, 6]))
      >>> x2 = ivy.Container(a=ivy.array([0, 7, 2]), b=ivy.array([3, 8, 5]))
      >>> res = x1.where((x1.a > x2.a), x2)
      >>> print(res)
      {
          a: ivy.array([1, 0, 1]),
          b: ivy.array([1, 0, 1])
      }
      """
      return self._static_where(self, x1, x2, out=out)
  
file_path: ivy/ivy/data_classes/container/searching.py
imports: from numbers import Number
  from typing import Optional, Union, List, Dict
  import ivy
  from ivy.data_classes.container.base import ContainerBase
label_desc: Use image node_id 8 for calling the _ContainerWithSearching obj's underlying member method code with example usage: obj.where() and returns: self