code: def ones(
      shape: Union[ivy.Shape, ivy.NativeShape],
      *,
      dtype: Optional[Union[ivy.Dtype, ivy.NativeDtype]] = None,
      device: Optional[Union[ivy.Device, ivy.NativeDevice]] = None,
      out: Optional[ivy.Array] = None,
  ) -> ivy.Array:
      """Return a new array having a specified ``shape`` and filled with ones.
  
      .. note::
  
          An output array having a complex floating-point data type must contain complex
          numbers having a real component equal to one and an imaginary component equal to
          zero (i.e., ``1 + 0j``).
  
      Parameters
      ----------
      shape
          output array shape.
      dtype
          output array data type. If ``dtype`` is ``None``, the output array data type
          must be the default floating-point data type. Default  ``None``.
      device
          device on which to place the created array. Default: ``None``.
      out
          optional output array, for writing the result to. It must have a shape that the
          inputs broadcast to.
  
      Returns
      -------
      ret
          an array containing ones.
  
  
      This function conforms to the `Array API Standard
      <https://data-apis.org/array-api/latest/>`_. This docstring is an extension of the
      `docstring <https://data-apis.org/array-api/latest/
      API_specification/generated/array_api.ones.html>`_
      in the standard.
  
      Both the description and the type hints above assumes an array input for simplicity,
      but this function is *nestable*, and therefore also accepts :class:`ivy.Container`
      instances in place of any of the arguments.
  
      Examples
      --------
      With :class:`ivy.Shape` input:
  
      >>> shape = (2,2)
      >>> x = ivy.ones(shape)
      >>> print(x)
      ivy.array([[1., 1.],
             [1., 1.]])
  
      With :class:`ivy.Dtype` input:
  
      >>> shape = (3,2)
      >>> d_type = ivy.int64
      >>> y = ivy.ones(shape, dtype=d_type)
      >>> print(y)
      ivy.array([[1, 1],
             [1, 1],
             [1, 1]])
  
      With :class:`ivy.Device` input:
  
      >>> shape = (3,2)
      >>> y = ivy.ones(shape, device="cpu")
      >>> print(y)
      ivy.array([[1., 1.],
             [1., 1.],
             [1., 1.]])
  
      With :class:`ivy.Array` input:
  
      >>> shape = (1, 5, 2)
      >>> x = ivy.zeros(shape)
      >>> ivy.ones(shape, out=x)
      >>> print(x)
      ivy.array([[[1., 1.],
              [1., 1.],
              [1., 1.],
              [1., 1.],
              [1., 1.]]])
      """
      return current_backend().ones(
          shape, dtype=dtype, device=device, out=out
      )
  
imports: from __future__ import annotations
  import functools
  from numbers import Number
  from typing import Union, Tuple, Optional, List, Sequence, Callable, Protocol, TypeVar, Iterable
  import numpy
  import ivy
  from ivy import to_ivy
  from ivy.utils.exceptions import handle_exceptions
  from ivy.utils.backend import current_backend
  from ivy.func_wrapper import handle_array_function, infer_dtype, handle_out_argument, outputs_to_ivy_arrays, inputs_to_native_arrays, inputs_to_native_shapes, to_native_arrays_and_back, handle_nestable, handle_array_like_without_promotion, handle_device, handle_backend_invalid, temp_asarray_wrapper
label_desc: Use image node_id 13 for calling a global function with example usage: ones(shape) and returns: current_backend