cmap

C API for registering a Node-API module exporting a strided array interface for applying a unary callback to a single-precision complex floating-point strided input array and assigning results to a single-precision complex floating-point strided output array.

Usage

var headerDir = require( '@stdlib/strided/napi/cmap' );

headerDir

Absolute file path for the directory containing header files for C APIs.

var dir = headerDir;
// returns <string>

Examples

var headerDir = require( '@stdlib/strided/napi/cmap' );

console.log( headerDir );
// => <string>

C APIs

Usage

#include "stdlib/strided/napi/cmap.h"

stdlib_strided_napi_cmap( env, info, fcn )

Invokes a strided array interface which applies a unary callback to a single-precision complex floating-point strided input array and assigns results to a single-precision complex floating-point strided output array.

#include <node_api.h>
#include <complex.h>

// ...

static float complex cidentityf( const float complex z ) {
    return z;
}

// ...

/**
* Receives JavaScript callback invocation data.
*
* @param env    environment under which the function is invoked
* @param info   callback data
* @return       Node-API value
*/
napi_value addon( napi_env env, napi_callback_info info ) {
    stdlib_strided_napi_cmap( env, info, cidentityf );
    return NULL;
}

// ...

The function accepts the following arguments:

  • env: [in] napi_env environment under which the function is invoked.
  • info: [in] napi_callback_info callback data.
  • fcn: [in] float complex (*fcn)( float complex ) unary callback.
void stdlib_strided_napi_cmap( napi_env env, napi_callback_info info, float complex (*fcn)( float complex ) );

STDLIB_STRIDED_NAPI_MODULE_CMAP( clbk )

Macro for registering a Node-API module exporting a strided array interface for applying a unary callback to a single-precision complex floating-point strided input array and assigning results to a single-precision complex floating-point strided output array.

#include <complex.h>

static float complex scale( const float complex z ) {
    float complex re = crealf( z );
    float complex im = cimagf( z );
    return ( re*10.0f ) + ( im*10.0f )*I;
}

// ...

// Register a Node-API module:
STDLIB_STRIDED_NAPI_MODULE_CMAP( scale )

The macro expects the following arguments:

  • clbk: float complex (*fcn)( float complex ) unary callback.

When used, this macro should be used instead of NAPI_MODULE. The macro includes NAPI_MODULE, thus ensuring Node-API module registration.

Notes

Did you find this page helpful?