docstr: ivy.Array 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
      Where True, yield x1, otherwise yield x2.
  x1
      input array. Should have a numeric data type.
  x2
      values from which to choose when condition is False.
  out
      optional output array, for writing the result to. It must have a shape that
      the inputs broadcast to.
  
  Returns
  -------
  ret
      An array with elements from self where condition is True, and elements from
      x2 otherwise.
  
  Examples
  --------
  >>> condition = ivy.array([[True, False], [True, True]])
  >>> x1 = ivy.array([[1, 2], [3, 4]])
  >>> x2 = ivy.array([[5, 6], [7, 8]])
  >>> res = x1.where(condition,x2)
  >>> print(res)
  ivy.array([[1, 0],
         [1, 1]])
docstr_tok: ["ivy.Array","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","Where","True",",","yield","x1",",","otherwise","yield","x2",".","x1","input","array",".","Should","have","a","numeric","data","type",".","x2","values","from","which","to","choose","when","condition","is","False",".","out","optional","output","array",",","for","writing","the","result","to",".","It","must","have","a","shape","that","the","inputs","broadcast","to",".","Returns","--","--","--","-","ret","An","array","with","elements","from","self","where","condition","is","True",",","and","elements","from","x2","otherwise",".","Examples","--","--","--","--",">",">",">","condition","=","ivy.array","(","[","[","True",",","False","]",",","[","True",",","True","]","]",")",">",">",">","x1","=","ivy.array","(","[","[","1",",","2","]",",","[","3",",","4","]","]",")",">",">",">","x2","=","ivy.array","(","[","[","5",",","6","]",",","[","7",",","8","]","]",")",">",">",">","res","=","x1.where","(","condition",",","x2",")",">",">",">","print","(","res",")","ivy.array","(","[","[","1",",","0","]",",","[","1",",","1","]","]",")"]
code: def where(
      self: ivy.Array,
      x1: ivy.Array,
      x2: ivy.Array,
      /,
      *,
      out: Optional[ivy.Array] = None,
  ) -> ivy.Array:
      """ivy.Array 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
          Where True, yield x1, otherwise yield x2.
      x1
          input array. Should have a numeric data type.
      x2
          values from which to choose when condition is False.
      out
          optional output array, for writing the result to. It must have a shape that
          the inputs broadcast to.
  
      Returns
      -------
      ret
          An array with elements from self where condition is True, and elements from
          x2 otherwise.
  
      Examples
      --------
      >>> condition = ivy.array([[True, False], [True, True]])
      >>> x1 = ivy.array([[1, 2], [3, 4]])
      >>> x2 = ivy.array([[5, 6], [7, 8]])
      >>> res = x1.where(condition,x2)
      >>> print(res)
      ivy.array([[1, 0],
             [1, 1]])
      """
      return ivy.where(self._data, x1._data, x2._data, out=out)
  
file_path: ivy/ivy/data_classes/array/searching.py
imports: import abc
  from numbers import Number
  from typing import Optional, Union, Tuple
  import ivy
label_desc: Use image node_id 4 for calling the _ArrayWithSearching obj's underlying member method code with example usage: obj.where() and returns: ivy