Skip to content

sub

Directory actions

More options

Directory actions

More options

Latest commit

 

History

History

sub

README.md

sub

Subtract two unsigned 32-bit integers.

Usage

var sub = require( '@stdlib/number/uint32/base/sub' );

sub( x, y )

Subtracts two unsigned 32-bit integers.

var v = sub( 5>>>0, 1>>>0 );
// returns 4

v = sub( 5>>>0, 2>>>0 );
// returns 3

v = sub( 5>>>0, 0>>>0 );
// returns 5

Notes

  • The function performs C-like subtraction of two unsigned 32-bit integers, including wraparound semantics.

Examples

var discreteUniform = require( '@stdlib/random/array/discrete-uniform' );
var logEachMap = require( '@stdlib/console/log-each-map' );
var sub = require( '@stdlib/number/uint32/base/sub' );

var opts = {
    'dtype': 'uint32'
};

// Create arrays of random values:
var x = discreteUniform( 100, 0, 50, opts );
var y = discreteUniform( 100, 0, 50, opts );

// Perform element-wise subtraction:
logEachMap( '%d - %d = %d', x, y, sub );

C APIs

Usage

#include "stdlib/number/uint32/base/sub.h"

stdlib_base_uint32_sub( x, y )

Subtracts two unsigned 32-bit integers.

#include <stdint.h>

uint32_t v = stdlib_base_uint32_sub( 5, 2 );
// returns 3

The function accepts the following arguments:

  • x: [in] uint32_t first input value.
  • y: [in] uint32_t second input value.
uint32_t stdlib_base_uint32_sub( const uint32_t x, const uint32_t y );

Examples

#include "stdlib/number/uint32/base/sub.h"
#include <stdint.h>
#include <stdio.h>

int main( void ) {
    const uint32_t x[] = { 3, 5, 10, 12 };
    const uint32_t y[] = { 6, 2, 11, 24 };

    uint32_t z;
    int i;
    for ( i = 0; i < 4; i++ ) {
        z = stdlib_base_uint32_sub( x[ i ], y[ i ] );
        printf( "%u - %u = %u\n", x[ i ], y[ i ], z );
    }
}