Binary Numbers

Base-2 binary numbers tests and operations. More...

Collaboration diagram for Binary Numbers:

Files
file	binary.scad
	Base-2 binary numbers tests and operations.

Functions
function	binary_bit_is (v, b, t=1)
	Test if a binary bit position of an integer value equals a test bit. More...
function	binary_i2v (v, w=1, bv=1)
	Encode an integer value as a binary list of bits. More...
function	binary_v2i (v)
	Decode a binary list of bits to an integer value. More...
function	binary_i2s (v, w=1)
	Encode an integer value as a binary string of bits. More...
function	binary_s2i (v)
	Decode a binary string of bits to an integer value. More...
function	binary_iw2i (v, s, w)
	Decode the binary bits of a bit window to an integer value. More...
function	binary_and (v1, v2, bv=1)
	Base-2 binary AND operation for integers. More...
function	binary_or (v1, v2, bv=1)
	Base-2 binary OR operation for integers. More...
function	binary_xor (v1, v2, bv=1)
	Base-2 binary XOR operation for integers. More...
function	binary_not (v, w=1, bv=1)
	Base-2 binary NOT operation for an integer. More...
function	binary_ishl (v, s=1, bm=1, bv=1)
	Base-2 binary left-shift operation for an integer. More...
function	binary_ishr (v, s=1)
	Base-2 binary right-shift operation for an integer. More...

Detailed Description

Base-2 binary numbers tests and operations.

Requires:
include <omdl-base.scad>;

Validation Summary

file	group	script	results	no test	skipped	passed	failed	warning
datatypes/binary.scad	Binary Numbers	Script	Results	0	0	156	0	0

No Failures

See complete validation results.

See Wikipedia binary numbers and operations for more information.

Function Documentation

binary_and()

function binary_and	(	v1	,
		v2	,
		bv	= 1
	)

Base-2 binary AND operation for integers.

Parameters

v1	<integer> An integer value.
v2	<integer> An integer value.
bv	(an internal recursion loop variable).

Returns

(1) <integer> the binary AND of v1 and v2. (2) Returns undef when v1 or v2 is not an integer.

binary_bit_is()

function binary_bit_is	(	v	,
		b	,
		t	= 1
	)

Test if a binary bit position of an integer value equals a test bit.

Parameters

v	<integer> An integer value.
b	<integer> A binary bit position.
t	<bit> The bit test value [0|1].

Returns

(1) <boolean> true when the binary bit position in v specified by b equals t, otherwise returns false. (2) Returns undef if v or b is not an integer.

Here is the caller graph for this function:

binary_i2s()

function binary_i2s	(	v	,
		w	= 1
	)

Encode an integer value as a binary string of bits.

Parameters

v	<integer> An integer value.
w	<integer> The minimum bit width.

Returns

(1) <bit-string> of bits binary encoding of the integer value. (2) Returns undef when v or w is not an integer.

binary_i2v()

function binary_i2v	(	v	,
		w	= 1,
		bv	= 1
	)

Encode an integer value as a binary list of bits.

Parameters

v	<integer> An integer value.
w	<integer> The minimum bit width.
bv	(an internal recursion loop variable).

Returns

(1) <bit-list> of bits binary encoding of the integer value. (2) Returns undef when v or w is not an integer.

The bit-list will be the minimum required to represent the value. If w is greater than the minimum required bits, then the value will be padded with '0'.

binary_ishl()

function binary_ishl	(	v	,
		s	= 1,
		bm	= 1,
		bv	= 1
	)

Base-2 binary left-shift operation for an integer.

Parameters

v	<integer> An integer value.
s	<integer> The number of bits to shift.
bm	(an internal recursion loop variable).
bv	(an internal recursion loop variable).

Returns

(1) <integer> the binary left-shift of v by s bits. (2) Returns undef when v or s is not an integer.

binary_ishr()

function binary_ishr	(	v	,
		s	= 1
	)

Base-2 binary right-shift operation for an integer.

Parameters

v	<integer> An integer value.
s	<integer> The number of bits to shift.

Returns

(1) <integer> the binary right-shift of v by s bits. (2) Returns undef when v or s is not an integer.

binary_iw2i()

function binary_iw2i	(	v	,
		s	,
		w
	)

Decode the binary bits of a bit window to an integer value.

Parameters

v	<integer> An integer value.
s	<integer> The bit window start offset.
w	<integer> The bit window width.

Returns

(1) <integer> value of the w bits of v starting at bit position s up to bit (w+s-1). (2) Returns undef when v, w, or s is not an integer.

Here is the caller graph for this function:

binary_not()

function binary_not	(	v	,
		w	= 1,
		bv	= 1
	)

Base-2 binary NOT operation for an integer.

Parameters

v	<integer> An integer value.
w	<integer> The minimum bit width.
bv	(an internal recursion loop variable).

Returns

(1) <integer> the binary NOT of v. (2) Returns undef when v or w is not an integer.

binary_or()

function binary_or	(	v1	,
		v2	,
		bv	= 1
	)

Base-2 binary OR operation for integers.

Parameters

v1	<integer> An integer value.
v2	<integer> An integer value.
bv	(an internal recursion loop variable).

Returns

(1) <integer> the binary OR of v1 and v2. (2) Returns undef when v1 or v2 is not an integer.

binary_s2i()

function binary_s2i

(

v

)

Decode a binary string of bits to an integer value.

Parameters

v	<bit-string> A value encoded as a binary string of bits.

Returns

(1) <integer> value encoding of the binary string of bits. (2) Returns undef when v is not a string of bit values.

binary_v2i()

function binary_v2i

(

v

)

Decode a binary list of bits to an integer value.

Parameters

v	<bit-list> A value encoded as a binary list of bits.

Returns

(1) <integer> value encoding of the binary list of bits. (2) Returns undef when v is not a list of bit values.

binary_xor()

function binary_xor	(	v1	,
		v2	,
		bv	= 1
	)

Base-2 binary XOR operation for integers.

Parameters

v1	<integer> An integer value.
v2	<integer> An integer value.
bv	(an internal recursion loop variable).

Returns

(1) <integer> the binary XOR of v1 and v2. (2) Returns undef when v1 or v2 is not an integer.