Usage

1#include "stdlib/napi/argv_int64.h"

stdlib_napi_argv_int64( env, value, *out, *message, *err )

Converts a Node-API value to a signed 64-bit integer.

1#include "stdlib/napi/argv_int64.h"
2#include <node_api.h>
3#include <stdint.h>
4
5static napi_value addon( napi_env env, napi_callback_info info ) {
6    napi_value value;
7
8    // ...
9
10    int64_t out;
11    napi_value err;
12    napi_status status = stdlib_napi_argv_int64( env, value, &out, "Must be a number.", &err );
13    assert( status == napi_ok );
14    if ( err != NULL ) {
15        assert( napi_throw( env, err ) == napi_ok );
16        return NULL;
17    }
18
19    // ...
20}

The function accepts the following arguments:

• env: [in] napi_env environment under which the function is invoked.
• value: [in] napi_value Node-API value.
• out: [out] int64_t* destination for storing output value.
• message: [in] char* error message.
• err: [out] napi_value* pointer for storing a JavaScript error. If not provided a number, the function sets err with a JavaScript error; otherwise, err is set to NULL.

1napi_status stdlib_napi_argv_int64( const napi_env env, const napi_value value, int64_t *out, const char *message, napi_value *err );

The function returns a napi_status status code indicating success or failure (returns napi_ok if success).

STDLIB_NAPI_ARGV_INT64( env, name, argv, index )

Macro for converting an add-on callback argument to a signed 64-bit integer.

1#include "stdlib/napi/argv_int64.h"
2#include "stdlib/napi/argv.h"
3#include <node_api.h>
4#include <stdint.h>
5
6static int64_t fcn( const int64_t v ) {
7    return v;
8}
9
10// ...
11
12static napi_value addon( napi_env env, napi_callback_info info ) {
13    // Retrieve add-on callback arguments:
14    STDLIB_NAPI_ARGV( env, info, argv, argc, 1 );
15
16    // Convert the first argument to a C type:
17    STDLIB_NAPI_ARGV_INT64( env, value, argv, 0 );
18
19    // ...
20
21    int64_t out = fcn( value );
22}

The macro expects the following arguments:

• env: environment under which the callback is invoked.
• name: output variable name.
• argv: name of the variable containing add-on callback arguments.
• index: argument index.