Assert Typed Array
Assert that a Node-API value is a typed array.
Usage
var headerDir = require( '@stdlib/assert/napi/is-typedarray' );
headerDir
Absolute file path for the directory containing header files for C APIs.
var dir = headerDir;
// returns <string>
Examples
var headerDir = require( '@stdlib/assert/napi/is-typedarray' );
console.log( headerDir );
// => <string>
C APIs
Usage
#include "stdlib/assert/napi/is_typedarray.h"
stdlib_assert_napi_value_is_typedarray( env, value, *message, *err )
Asserts that a Node-API value is a typed array.
#include "stdlib/assert/napi/is_typedarray.h"
#include <node_api.h>
static napi_value addon( napi_env env, napi_callback_info info ) {
napi_value value;
// ...
napi_value err;
napi_status status = stdlib_assert_napi_value_is_typedarray( env, value, "Must be a typed array.", &err );
assert( status == napi_ok );
if ( err != NULL ) {
assert( napi_throw( env, err ) == napi_ok );
return NULL;
}
// ...
}
The function accepts the following arguments:
- env:
[in] napi_env
environment under which the function is invoked. - value:
[in] napi_value
Node-API value. - message:
[in] char*
error message. - err:
[out] napi_value*
pointer for storing a JavaScript error.
napi_status stdlib_assert_napi_value_is_typedarray( const napi_env env, const napi_value value, const char *message, napi_value *err );
The function returns a napi_status
status code indicating success or failure (returns napi_ok
if success).
Notes
- If not provided a typed array, the function sets
err
with a JavaScript error; otherwise,err
is set toNULL
.