docs: add note clarifying behavior for out-of-bounds indices

data-apis · kgryte · Dec 14, 2023 · Nov 6, 2023 · Nov 6, 2023 · 84727ac0ae389464a5d65d52158018705b2b786e
commit 84727ac0ae389464a5d65d52158018705b2b786e
diff --git a/src/array_api_stubs/_draft/indexing_functions.py b/src/array_api_stubs/_draft/indexing_functions.py
@@ -16,6 +16,10 @@ def take(x: array, indices: array, /, *, axis: Optional[int] = None) -> array:
         input array.
     indices: array
         array indices. The array must be one-dimensional and have an integer data type.
+
+        .. note::
+           This specification does not require bounds checking. The behavior for out-of-bounds indices is left unspecified.
+
     axis: int
         axis over which to select values. If ``axis`` is negative, the function must determine the axis along which to select values by counting from the last dimension.