Document C APIs

Author: kgryte

lib/node_modules/@stdlib/ndarray/ctor/README.md

@@ -2299,7 +2299,7 @@ The function accepts the following arguments:
 
 -   **arr**: `[in] struct ndarray*` input ndarray.
 -   **idx**: `[in] int64_t` linear view index.
--   **v**: `[in] void *` value to set.
+-   **v**: `[in] void*` value to set.
 
 Notes:
 
@@ -2495,6 +2495,216 @@ Notes:
 
 -   The function returns `-1` if unable to set an element and `0` otherwise.
 
+* * *
+
+#### stdlib_ndarray_set( \*arr, \*sub, \*v )
+
+Sets an ndarray data element.
+
+```c
+int8_t stdlib_ndarray_set( const struct ndarray *arr, const int64_t *sub, const void *v );
+```
+
+The function accepts the following arguments:
+
+-   **arr**: `[in] struct ndarray*` input ndarray.
+-   **sub**: `[in] int64_t*` ndarray subscripts.
+-   **v**: `[in] void*` value to set.
+
+Notes
+
+-   The function returns `-1` if unable to set an element and `0` otherwise.
+-   The function requires a pointer to a data value `v` in order to provide a generic API supporting ndarrays having different data types.
+-   The function has no way of determining whether `v` actually points to a memory address compatible with the underlying input ndarray data type. Accordingly, accessing **unowned** memory is possible, and this function **assumes** you know what you are doing.
+
+#### stdlib_ndarray_set_float64( \*arr, \*sub, v )
+
+Sets a double-precision floating-point ndarray data element.
+
+```c
+int8_t stdlib_ndarray_set_float64( const struct ndarray *arr, const int64_t *sub, const double v );
+```
+
+The function accepts the following arguments:
+
+-   **arr**: `[in] struct ndarray*` input ndarray.
+-   **sub**: `[in] int64_t*` ndarray subscripts.
+-   **v**: `[in] double` value to set.
+
+Notes
+
+-   The function does **not** verify that the type of `v` matches the underlying input ndarray data type, and, thus, overwriting **unowned** memory is possible. The function **assumes** that you know what you are doing.
+-   The function returns `-1` if unable to set an element and `0` otherwise.
+
+#### stdlib_ndarray_set_float32( \*arr, \*sub, v )
+
+Sets a single-precision floating-point ndarray data element.
+
+```c
+int8_t stdlib_ndarray_set_float32( const struct ndarray *arr, const int64_t *sub, const float v );
+```
+
+The function accepts the following arguments:
+
+-   **arr**: `[in] struct ndarray*` input ndarray.
+-   **sub**: `[in] int64_t*` ndarray subscripts.
+-   **v**: `[in] float` value to set.
+
+Notes
+
+-   The function does **not** verify that the type of `v` matches the underlying input ndarray data type, and, thus, overwriting **unowned** memory is possible. The function **assumes** that you know what you are doing.
+-   The function returns `-1` if unable to set an element and `0` otherwise.
+
+#### stdlib_ndarray_set_uint64( \*arr, \*sub, v )
+
+Sets an unsigned 64-bit integer ndarray data element.
+
+```c
+int8_t stdlib_ndarray_set_uint64( const struct ndarray *arr, const int64_t *sub, const uint64_t v );
+```
+
+The function accepts the following arguments:
+
+-   **arr**: `[in] struct ndarray*` input ndarray.
+-   **sub**: `[in] int64_t*` ndarray subscripts.
+-   **v**: `[in] uint64_t` value to set.
+
+Notes
+
+-   The function does **not** verify that the type of `v` matches the underlying input ndarray data type, and, thus, overwriting **unowned** memory is possible. The function **assumes** that you know what you are doing.
+-   The function returns `-1` if unable to set an element and `0` otherwise.
+
+#### stdlib_ndarray_set_int64( \*arr, \*sub, v )
+
+Sets a signed 64-bit integer ndarray data element.
+
+```c
+int8_t stdlib_ndarray_set_int64( const struct ndarray *arr, const int64_t *sub, const int64_t v );
+```
+
+The function accepts the following arguments:
+
+-   **arr**: `[in] struct ndarray*` input ndarray.
+-   **sub**: `[in] int64_t*` ndarray subscripts.
+-   **v**: `[in] int64_t` value to set.
+
+Notes
+
+-   The function does **not** verify that the type of `v` matches the underlying input ndarray data type, and, thus, overwriting **unowned** memory is possible. The function **assumes** that you know what you are doing.
+-   The function returns `-1` if unable to set an element and `0` otherwise.
+
+#### stdlib_ndarray_set_uint32( \*arr, \*sub, v )
+
+Sets an unsigned 32-bit integer ndarray data element.
+
+```c
+int8_t stdlib_ndarray_set_uint32( const struct ndarray *arr, const int64_t *sub, const uint32_t v );
+```
+
+The function accepts the following arguments:
+
+-   **arr**: `[in] struct ndarray*` input ndarray.
+-   **sub**: `[in] int64_t*` ndarray subscripts.
+-   **v**: `[in] uint32_t` value to set.
+
+Notes
+
+-   The function does **not** verify that the type of `v` matches the underlying input ndarray data type, and, thus, overwriting **unowned** memory is possible. The function **assumes** that you know what you are doing.
+-   The function returns `-1` if unable to set an element and `0` otherwise.
+
+#### stdlib_ndarray_set_int32( \*arr, \*sub, v )
+
+Sets a signed 32-bit integer ndarray data element.
+
+```c
+int8_t stdlib_ndarray_set_int32( const struct ndarray *arr, const int64_t *sub, const int32_t v );
+```
+
+The function accepts the following arguments:
+
+-   **arr**: `[in] struct ndarray*` input ndarray.
+-   **sub**: `[in] int64_t*` ndarray subscripts.
+-   **v**: `[in] int32_t` value to set.
+
+Notes
+
+-   The function does **not** verify that the type of `v` matches the underlying input ndarray data type, and, thus, overwriting **unowned** memory is possible. The function **assumes** that you know what you are doing.
+-   The function returns `-1` if unable to set an element and `0` otherwise.
+
+#### stdlib_ndarray_set_uint16( \*arr, \*sub, v )
+
+Sets an unsigned 16-bit integer ndarray data element.
+
+```c
+int8_t stdlib_ndarray_set_uint16( const struct ndarray *arr, const int64_t *sub, const uint16_t v );
+```
+
+The function accepts the following arguments:
+
+-   **arr**: `[in] struct ndarray*` input ndarray.
+-   **sub**: `[in] int64_t*` ndarray subscripts.
+-   **v**: `[in] uint16_t` value to set.
+
+Notes
+
+-   The function does **not** verify that the type of `v` matches the underlying input ndarray data type, and, thus, overwriting **unowned** memory is possible. The function **assumes** that you know what you are doing.
+-   The function returns `-1` if unable to set an element and `0` otherwise.
+
+#### stdlib_ndarray_set_int16( \*arr, \*sub, v )
+
+Sets a signed 16-bit integer ndarray data element.
+
+```c
+int8_t stdlib_ndarray_set_int16( const struct ndarray *arr, const int64_t *sub, const int16_t v );
+```
+
+The function accepts the following arguments:
+
+-   **arr**: `[in] struct ndarray*` input ndarray.
+-   **sub**: `[in] int64_t*` ndarray subscripts.
+-   **v**: `[in] int16_t` value to set.
+
+Notes
+
+-   The function does **not** verify that the type of `v` matches the underlying input ndarray data type, and, thus, overwriting **unowned** memory is possible. The function **assumes** that you know what you are doing.
+-   The function returns `-1` if unable to set an element and `0` otherwise.
+
+#### stdlib_ndarray_set_uint8( \*arr, \*sub, v )
+
+Sets an unsigned 8-bit integer ndarray data element.
+
+```c
+int8_t stdlib_ndarray_set_uint8( const struct ndarray *arr, const int64_t *sub, const uint8_t v );
+```
+
+The function accepts the following arguments:
+
+-   **arr**: `[in] struct ndarray*` input ndarray.
+-   **sub**: `[in] int64_t*` ndarray subscripts.
+-   **v**: `[in] uint8_t` value to set.
+
+Notes
+
+-   The function returns `-1` if unable to set an element and `0` otherwise.
+
+#### stdlib_ndarray_set_int8( \*arr, \*sub, v )
+
+Sets a signed 8-bit integer ndarray data element.
+
+```c
+int8_t stdlib_ndarray_set_int8( const struct ndarray *arr, const int64_t *sub, const int8_t v );
+```
+
+The function accepts the following arguments:
+
+-   **arr**: `[in] struct ndarray*` input ndarray.
+-   **sub**: `[in] int64_t*` ndarray subscripts.
+-   **v**: `[in] int8_t` value to set.
+
+Notes
+
+-   The function returns `-1` if unable to set an element and `0` otherwise.
+
 </section>
 
 <!-- /.usage -->