@stdlib/complex-float32-ctor

v0.0.2

Published

5 months ago

64-bit complex number.

Downloads

189,107

Complex64

64-bit complex number.

Installation

npm install @stdlib/complex-float32-ctor

Usage

var Complex64 = require( '@stdlib/complex-float32-ctor' );

Complex64( real, imag )

64-bit complex number constructor, where real and imag are the real and imaginary components, respectively.

var z = new Complex64( 5.0, 3.0 );
// returns <Complex64>

Properties

Complex64.BYTES_PER_ELEMENT

Size (in bytes) of each component.

var nbytes = Complex64.BYTES_PER_ELEMENT;
// returns 4

Complex64.prototype.BYTES_PER_ELEMENT

Size (in bytes) of each component.

var z = new Complex64( 5.0, 3.0 );

var nbytes = z.BYTES_PER_ELEMENT;
// returns 4

Complex64.prototype.byteLength

Length (in bytes) of a complex number.

var z = new Complex64( 5.0, 3.0 );

var nbytes = z.byteLength;
// returns 8

Instance

A Complex64 instance has the following properties...

re

A read-only property returning the real component.

var z = new Complex64( 5.0, 3.0 );

var re = z.re;
// returns 5.0

im

A read-only property returning the imaginary component.

var z = new Complex64( 5.0, -3.0 );

var im = z.im;
// returns -3.0

Methods

Accessor Methods

These methods do not mutate a Complex64 instance and, instead, return a complex number representation.

Complex64.prototype.toString()

Returns a string representation of a Complex64 instance.

var z = new Complex64( 5.0, 3.0 );
var str = z.toString();
// returns '5 + 3i'

z = new Complex64( -5.0, -3.0 );
str = z.toString();
// returns '-5 - 3i'

Complex64.prototype.toJSON()

Returns a JSON representation of a Complex64 instance. JSON.stringify() implicitly calls this method when stringifying a Complex64 instance.

var z = new Complex64( 5.0, -3.0 );

var o = z.toJSON();
/*
  {
    "type": "Complex64",
    "re": 5.0,
    "im": -3.0
  }
*/

To revive a Complex64 number from a JSON string, see @stdlib/complex/float32/reviver.

Notes

Both the real and imaginary components are stored as single-precision floating-point numbers.

Examples

var Complex64 = require( '@stdlib/complex-float32-ctor' );

var z = new Complex64( 3.0, -2.0 );

console.log( 'type: %s', typeof z );
// => 'type: object'

console.log( 'str: %s', z );
// => 'str: 3 - 2i'

console.log( 'real: %d', z.re );
// => 'real: 3'

console.log( 'imaginary: %d', z.im );
// => 'imaginary: -2'

console.log( 'JSON: %s', JSON.stringify( z ) );
// => 'JSON: {"type":"Complex64","re":3,"im":-2}'

C APIs

Usage

#include "stdlib/complex/float32/ctor.h"

stdlib_complex64_t

An opaque type definition for a single-precision complex floating-point number.

stdlib_complex64_t z = stdlib_complex64( 5.0f, 2.0f );

stdlib_complex64_parts_t

An opaque type definition for a union for accessing the real and imaginary parts of a single-precision complex floating-point number.

float realf( const stdlib_complex64_t z ) {
    stdlib_complex64_parts_t v;

    // Assign a single-precision complex floating-point number:
    v.value = z;

    // Extract the real component:
    float re = v.parts[ 0 ];

    return re;
}

// ...

// Create a complex number:
stdlib_complex64_t z = stdlib_complex64( 5.0f, 2.0f );

// ...

// Access the real component:
float re = realf( z );
// returns 5.0f

The union has the following members:

value: stdlib_complex64_t single-precision complex floating-point number.
parts: float[] array having the following elements:
- 0: float real component.
- 1: float imaginary component.