Skip to content

sub

Directory actions

More options

Directory actions

More options

Latest commit

 

History

History

sub

README.md

sub

Subtract two unsigned 8-bit integers.

Usage

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

sub( x, y )

Subtracts two unsigned 8-bit integers.

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

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

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

Notes

  • The function performs C-like subtraction of two unsigned 8-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/uint8/base/sub' );

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

// 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/uint8/base/sub.h"

stdlib_base_uint8_sub( x, y )

Subtracts two unsigned 8-bit integers.

#include <stdint.h>

uint8_t v = stdlib_base_uint8_sub( 5, 2 );
// returns 3

The function accepts the following arguments:

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

Examples

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

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

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