diff --git a/spec/draft/API_specification/elementwise_functions.rst b/spec/draft/API_specification/elementwise_functions.rst
index 0e5fd0609..8048eb38a 100644
--- a/spec/draft/API_specification/elementwise_functions.rst
+++ b/spec/draft/API_specification/elementwise_functions.rst
@@ -34,6 +34,7 @@ Objects in API
bitwise_xor
ceil
conj
+ copysign
cos
cosh
divide
diff --git a/src/array_api_stubs/_draft/elementwise_functions.py b/src/array_api_stubs/_draft/elementwise_functions.py
index 147eff9cd..faaa9213b 100644
--- a/src/array_api_stubs/_draft/elementwise_functions.py
+++ b/src/array_api_stubs/_draft/elementwise_functions.py
@@ -16,6 +16,7 @@
"bitwise_xor",
"ceil",
"conj",
+ "copysign",
"cos",
"cosh",
"divide",
@@ -804,6 +805,47 @@ def conj(x: array, /) -> array:
"""
+def copysign(x1: array, x2: array, /) -> array:
+ r"""
+ Composes a floating-point value with the magnitude of ``x1_i`` and the sign of ``x2_i`` for each element of the input array ``x1``.
+
+ Parameters
+ ----------
+ x1: array
+ input array containing magnitudes. Should have a real-valued floating-point data type.
+ x2: array
+ input array whose sign bits are applied to the magnitudes of ``x1``. Must be compatible with ``x1`` (see :ref:`broadcasting`). Should have a real-valued floating-point data type.
+
+ Returns
+ -------
+ out: array
+ an array containing the element-wise results. The returned array must have a floating-point data type determined by :ref:`type-promotion`.
+
+ Notes
+ -----
+
+ **Special cases**
+
+ For real-valued floating-point operands, let ``|x|`` be the absolute value, and if ``x1_i`` is not ``NaN``,
+
+ - If ``x2_i`` is less than ``0``, the result is ``-|x1_i|``.
+ - If ``x2_i`` is ``-0``, the result is ``-|x1_i|``.
+ - If ``x2_i`` is ``+0``, the result is ``|x1_i|``.
+ - If ``x2_i`` is greater than ``0``, the result is ``|x1_i|``.
+ - If ``x2_i`` is ``NaN`` and the sign bit of ``x2_i`` is ``1``, the result is ``-|x1_i|``.
+ - If ``x2_i`` is ``NaN`` and the sign bit of ``x2_i`` is ``0``, the result is ``|x1_i|``.
+
+ If ``x1_i`` is ``NaN``,
+
+ - If ``x2_i`` is less than ``0``, the result is ``NaN`` with a sign bit of ``1``.
+ - If ``x2_i`` is ``-0``, the result is ``NaN`` with a sign bit of ``1``.
+ - If ``x2_i`` is ``+0``, the result is ``NaN`` with a sign bit of ``0``.
+ - If ``x2_i`` is greater than ``0``, the result is ``NaN`` with a sign bit of ``0``.
+ - If ``x2_i`` is ``NaN`` and the sign bit of ``x2_i`` is ``1``, the result is ``NaN`` with a sign bit of ``1``.
+ - If ``x2_i`` is ``NaN`` and the sign bit of ``x2_i`` is ``0``, the result is ``NaN`` with a sign bit of ``0``.
+ """
+
+
def cos(x: array, /) -> array:
r"""
Calculates an implementation-dependent approximation to the cosine for each element ``x_i`` of the input array ``x``.
pFad - Phonifier reborn
Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.
Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.
Alternative Proxies:
Alternative Proxy
pFad Proxy
pFad v3 Proxy
pFad v4 Proxy