Key compare function prototype

Key compare function is used by searching and sorting algorithms. It takes two constant keys and returns relation between them as signed integer number: 0 if first key is equal to second key; 1 if first key is greater than second key, and -1 if first key is less than second key.

Each user defined key compare function should conform to the prototype specified below.

C/C++sint64_t Cmp (const void *key1, const void *key2);

Parameters:

• key1 - a constant pointer to first key
• key2 - a constant pointer to second key

Return value:

• -1 - if first key is less than second key
• 0 - if first key is equal to second key
• +1 - if first key is greater than second key

Initialization

C
Unsigned integer types
void Array_Init_uint8 (uint8_t array[], size_t size, uint8_t value);
void Array_Init_uint16 (uint16_t array[], size_t size, uint16_t value);
void Array_Init_uint32 (uint32_t array[], size_t size, uint32_t value);
void Array_Init_uint64 (uint64_t array[], size_t size, uint64_t value);

Signed integer types
void Array_Init_sint8 (sint8_t array[], size_t size, sint8_t value);
void Array_Init_sint16 (sint16_t array[], size_t size, sint16_t value);
void Array_Init_sint32 (sint32_t array[], size_t size, sint32_t value);
void Array_Init_sint64 (sint64_t array[], size_t size, sint64_t value);

Floating-point types
void Array_Init_flt32 (flt32_t array[], size_t size, flt32_t value);
void Array_Init_flt64 (flt64_t array[], size_t size, flt64_t value);

Other types
void Array_Init_size (size_t array[], size_t size, size_t value);

C++
Unsigned integer types
void Array::Init (uint8_t array[], size_t size, uint8_t value);
void Array::Init (uint16_t array[], size_t size, uint16_t value);
void Array::Init (uint32_t array[], size_t size, uint32_t value);
void Array::Init (uint64_t array[], size_t size, uint64_t value);

Signed integer types
void Array::Init (sint8_t array[], size_t size, sint8_t value);
void Array::Init (sint16_t array[], size_t size, sint16_t value);
void Array::Init (sint32_t array[], size_t size, sint32_t value);
void Array::Init (sint64_t array[], size_t size, sint64_t value);

Floating-point types
void Array::Init (flt32_t array[], size_t size, flt32_t value);
void Array::Init (flt64_t array[], size_t size, flt64_t value);

Other types
void Array::Init (size_t array[], size_t size, size_t value);

Description: Init all array elements with specified value.

Parameters:

• array - pointer to array
• size - size of array (count of elements)
• value - initialization value for all elements

Return value: None.

Copying arrays

C
Unsigned integer types
void Array_Copy_uint8 (uint8_t target[], const uint8_t source[], size_t size);
void Array_Copy_uint16 (uint16_t target[], const uint16_t source[], size_t size);
void Array_Copy_uint32 (uint32_t target[], const uint32_t source[], size_t size);
void Array_Copy_uint64 (uint64_t target[], const uint64_t source[], size_t size);

Signed integer types
void Array_Copy_sint8 (sint8_t target[], const sint8_t source[], size_t size);
void Array_Copy_sint16 (sint16_t target[], const sint16_t source[], size_t size);
void Array_Copy_sint32 (sint32_t target[], const sint32_t source[], size_t size);
void Array_Copy_sint64 (sint64_t target[], const sint64_t source[], size_t size);

Floating-point types
void Array_Copy_flt32 (flt32_t target[], const flt32_t source[], size_t size);
void Array_Copy_flt64 (flt64_t target[], const flt64_t source[], size_t size);

Other types
void Array_Copy_size (size_t target[], const size_t source[], size_t size);
void Array_Copy (void *target, const void *source, size_t size);

C++
Unsigned integer types
void Array::Copy (uint8_t target[], const uint8_t source[], size_t size);
void Array::Copy (uint16_t target[], const uint16_t source[], size_t size);
void Array::Copy (uint32_t target[], const uint32_t source[], size_t size);
void Array::Copy (uint64_t target[], const uint64_t source[], size_t size);

Signed integer types
void Array::Copy (sint8_t target[], const sint8_t source[], size_t size);
void Array::Copy (sint16_t target[], const sint16_t source[], size_t size);
void Array::Copy (sint32_t target[], const sint32_t source[], size_t size);
void Array::Copy (sint64_t target[], const sint64_t source[], size_t size);

Floating-point types
void Array::Copy (flt32_t target[], const flt32_t source[], size_t size);
void Array::Copy (flt64_t target[], const flt64_t source[], size_t size);

Other types
void Array::Copy (size_t target[], const size_t source[], size_t size);
void Array::Copy (void *target, const void *source, size_t size);

Description: Copy all elements from source array to target array.

Parameters:

• target - pointer to target array
• source - pointer to source array
• size - size of arrays (count of elements)

Return value: None.

Warning:If arrays are overlapped in memory, then content of the source array will be unexpectedly modified, and content of the target array will be also undefined.

Moving arrays

C
Unsigned integer types
void Array_Move_uint8 (uint8_t target[], uint8_t source[], size_t size);
void Array_Move_uint16 (uint16_t target[], uint16_t source[], size_t size);
void Array_Move_uint32 (uint32_t target[], uint32_t source[], size_t size);
void Array_Move_uint64 (uint64_t target[], uint64_t source[], size_t size);

Signed integer types
void Array_Move_sint8 (sint8_t target[], sint8_t source[], size_t size);
void Array_Move_sint16 (sint16_t target[], sint16_t source[], size_t size);
void Array_Move_sint32 (sint32_t target[], sint32_t source[], size_t size);
void Array_Move_sint64 (sint64_t target[], sint64_t source[], size_t size);

Floating-point types
void Array_Move_flt32 (flt32_t target[], flt32_t source[], size_t size);
void Array_Move_flt64 (flt64_t target[], flt64_t source[], size_t size);

Other types
void Array_Move_size (size_t target[], size_t source[], size_t size);
void Array_Move (void *target, void *source, size_t size);

C++
Unsigned integer types
void Array::Move (uint8_t target[], uint8_t source[], size_t size);
void Array::Move (uint16_t target[], uint16_t source[], size_t size);
void Array::Move (uint32_t target[], uint32_t source[], size_t size);
void Array::Move (uint64_t target[], uint64_t source[], size_t size);

Signed integer types
void Array::Move (sint8_t target[], sint8_t source[], size_t size);
void Array::Move (sint16_t target[], sint16_t source[], size_t size);
void Array::Move (sint32_t target[], sint32_t source[], size_t size);
void Array::Move (sint64_t target[], sint64_t source[], size_t size);

Floating-point types
void Array::Move (flt32_t target[], flt32_t source[], size_t size);
void Array::Move (flt64_t target[], flt64_t source[], size_t size);

Other types
void Array::Move (size_t target[], size_t source[], size_t size);
void Array::Move (void *target, void *source, size_t size);

Description: Move elements from source array to target array.

Parameters:

• target - pointer to target array
• source - pointer to source array
• size - size of arrays (count of elements)

Return value: None.

Pattern cloning

C
Unsigned integer types
void Array_Clone_uint8 (uint8_t array[], size_t size, size_t psize);
void Array_Clone_uint16 (uint16_t array[], size_t size, size_t psize);
void Array_Clone_uint32 (uint32_t array[], size_t size, size_t psize);
void Array_Clone_uint64 (uint64_t array[], size_t size, size_t psize);

Signed integer types
void Array_Clone_sint8 (sint8_t array[], size_t size, size_t psize);
void Array_Clone_sint16 (sint16_t array[], size_t size, size_t psize);
void Array_Clone_sint32 (sint32_t array[], size_t size, size_t psize);
void Array_Clone_sint64 (sint64_t array[], size_t size, size_t psize);

Floating-point types
void Array_Clone_flt32 (flt32_t array[], size_t size, size_t psize);
void Array_Clone_flt64 (flt64_t array[], size_t size, size_t psize);

Other types
void Array_Clone_size (size_t array[], size_t size, size_t psize);
void Array_Clone (void *array, size_t size, size_t psize);

C++
Unsigned integer types
void Array::Clone (uint8_t array[], size_t size, size_t psize);
void Array::Clone (uint16_t array[], size_t size, size_t psize);
void Array::Clone (uint32_t array[], size_t size, size_t psize);
void Array::Clone (uint64_t array[], size_t size, size_t psize);

Signed integer types
void Array::Clone (sint8_t array[], size_t size, size_t psize);
void Array::Clone (sint16_t array[], size_t size, size_t psize);
void Array::Clone (sint32_t array[], size_t size, size_t psize);
void Array::Clone (sint64_t array[], size_t size, size_t psize);

Floating-point types
void Array::Clone (flt32_t array[], size_t size, size_t psize);
void Array::Clone (flt64_t array[], size_t size, size_t psize);

Other types
void Array::Clone (size_t array[], size_t size, size_t psize);
void Array::Clone (void *array, size_t size, size_t psize);

Description: Clone pattern (few elements from beginning of array) through the entire array.

Parameters:

• array - pointer to array, which holds pattern
• size - size of array (count of elements)
• psize - pattern size (count of elements to be repeated until the end of array)

Return value: None.

Data conversion

These functions convert array elements to different floating-point and integer types, using current rounding mode which is set in the MXCSR register of processor. They use SIMD extension for data conversion, and that is why they ignoring FPU rounding mode.

Conversion between floating-point types

Cvoid Array_ConvertToFlt32_flt64 (flt32_t target[], const flt64_t source[], size_t size);
void Array_ConvertToFlt64_flt32 (flt64_t target[], const flt32_t source[], size_t size);

C++void Array::ConvertToFlt32 (flt32_t target[], const flt64_t source[], size_t size);
void Array::ConvertToFlt64 (flt64_t target[], const flt32_t source[], size_t size);

Description: Convert source array elements from one floating-point type to another, and store converted elements to target array.

Parameters:

• target - pointer to target array
• source - pointer to source array
• size - size of arrays (count of elements)

Return value: None.

Note:Array elements are rounded according to the current SIMD rounding mode.

Conversion from signed integer types to floating-point types

Cvoid Array_ConvertToFlt32_sint32 (flt32_t target[], const sint32_t source[], size_t size);
void Array_ConvertToFlt32_sint64 (flt32_t target[], const sint64_t source[], size_t size);
void Array_ConvertToFlt64_sint32 (flt64_t target[], const sint32_t source[], size_t size);
void Array_ConvertToFlt64_sint64 (flt64_t target[], const sint64_t source[], size_t size);

C++void Array::ConvertToFlt32 (flt32_t target[], const sint32_t source[], size_t size);
void Array::ConvertToFlt32 (flt32_t target[], const sint64_t source[], size_t size);
void Array::ConvertToFlt64 (flt64_t target[], const sint32_t source[], size_t size);
void Array::ConvertToFlt64 (flt64_t target[], const sint64_t source[], size_t size);

Description: Convert source array elements from signed integer type to different floating-point types, and store converted elements to target array.

Parameters:

• target - pointer to target array
• source - pointer to source array
• size - size of arrays (count of elements)

Return value: None.

Conversion from floating-point types to signed integer types

Cvoid Array_ConvertToSint32_flt32 (sint32_t target[], const flt32_t source[], size_t size);
void Array_ConvertToSint32_flt64 (sint32_t target[], const flt64_t source[], size_t size);
void Array_ConvertToSint64_flt32 (sint64_t target[], const flt32_t source[], size_t size);
void Array_ConvertToSint64_flt64 (sint64_t target[], const flt64_t source[], size_t size);

C++void Array::ConvertToSint32 (sint32_t target[], const flt32_t source[], size_t size);
void Array::ConvertToSint32 (sint32_t target[], const flt64_t source[], size_t size);
void Array::ConvertToSint64 (sint64_t target[], const flt32_t source[], size_t size);
void Array::ConvertToSint64 (sint64_t target[], const flt64_t source[], size_t size);

Description: Convert source array elements from different floating-point types to signed integer type, and store converted elements to target array.

Parameters:

• target - pointer to target array
• source - pointer to source array
• size - size of arrays (count of elements)

Return value: None.

Note:Array elements are rounded according to the current SIMD rounding mode.

Truncating from floating-point types to signed integer types

Cvoid Array_TruncateToSint32_flt32 (sint32_t target[], const flt32_t source[], size_t size);
void Array_TruncateToSint32_flt64 (sint32_t target[], const flt64_t source[], size_t size);
void Array_TruncateToSint64_flt32 (sint64_t target[], const flt32_t source[], size_t size);
void Array_TruncateToSint64_flt64 (sint64_t target[], const flt64_t source[], size_t size);

C++void Array::TruncateToSint32 (sint32_t target[], const flt32_t source[], size_t size);
void Array::TruncateToSint32 (sint32_t target[], const flt64_t source[], size_t size);
void Array::TruncateToSint64 (sint64_t target[], const flt32_t source[], size_t size);
void Array::TruncateToSint64 (sint64_t target[], const flt64_t source[], size_t size);

Description: Convert source array elements from different floating-point types to signed integer type, using round to zero (truncate) mode, and store converted elements to target array.

Parameters:

• target - pointer to target array
• source - pointer to source array
• size - size of arrays (count of elements)

Return value: None.

Bit field operations

Bit field operations treat array as continuous bit bield, which stores sequence of independent bits. You may extract bit values from there or change any bit without touching its neighbors. All operations touch only one bit per function call.

Get bit value from bit field

C
Unsigned integer types
bool Array_GetBit_uint8 (const uint8_t array[], size_t index);
bool Array_GetBit_uint16 (const uint16_t array[], size_t index);
bool Array_GetBit_uint32 (const uint32_t array[], size_t index);
bool Array_GetBit_uint64 (const uint64_t array[], size_t index);

Signed integer types
bool Array_GetBit_sint8 (const sint8_t array[], size_t index);
bool Array_GetBit_sint16 (const sint16_t array[], size_t index);
bool Array_GetBit_sint32 (const sint32_t array[], size_t index);
bool Array_GetBit_sint64 (const sint64_t array[], size_t index);

Other types
bool Array_GetBit_size (const size_t array[], size_t index);
bool Array_GetBit (const void *array, size_t index);

C++
Unsigned integer types
bool Array::GetBit (const uint8_t array[], size_t index);
bool Array::GetBit (const uint16_t array[], size_t index);
bool Array::GetBit (const uint32_t array[], size_t index);
bool Array::GetBit (const uint64_t array[], size_t index);

Signed integer types
bool Array::GetBit (const sint8_t array[], size_t index);
bool Array::GetBit (const sint16_t array[], size_t index);
bool Array::GetBit (const sint32_t array[], size_t index);
bool Array::GetBit (const sint64_t array[], size_t index);

Other types
bool Array::GetBit (const size_t array[], size_t index);
bool Array::GetBit (const void *array, size_t index);

Description: Extract bit value from bit field, treating array pointer as beginning position of the bit field. Bit index is calculated from that position. First byte has index values from 0 to 7. Second byte starts from 8 index and so on.

Parameters:

• array - pointer to array
• index - bit position. First bit has zero index.

Return value:

• TRUE (1) if bit is set.
• FALSE (0) if bit is not set.

Set bit value in bit field

C
Unsigned integer types
void Array_SetBit_uint8 (uint8_t array[], size_t index);
void Array_SetBit_uint16 (uint16_t array[], size_t index);
void Array_SetBit_uint32 (uint32_t array[], size_t index);
void Array_SetBit_uint64 (uint64_t array[], size_t index);

Signed integer types
void Array_SetBit_sint8 (sint8_t array[], size_t index);
void Array_SetBit_sint16 (sint16_t array[], size_t index);
void Array_SetBit_sint32 (sint32_t array[], size_t index);
void Array_SetBit_sint64 (sint64_t array[], size_t index);

Other types
void Array_SetBit_size (size_t array[], size_t index);
void Array_SetBit (void *array, size_t index);

C++
Unsigned integer types
void Array::SetBit (uint8_t array[], size_t index);
void Array::SetBit (uint16_t array[], size_t index);
void Array::SetBit (uint32_t array[], size_t index);
void Array::SetBit (uint64_t array[], size_t index);

Signed integer types
void Array::SetBit (sint8_t array[], size_t index);
void Array::SetBit (sint16_t array[], size_t index);
void Array::SetBit (sint32_t array[], size_t index);
void Array::SetBit (sint64_t array[], size_t index);

Other types
void Array::SetBit (size_t array[], size_t index);
void Array::SetBit (void *array, size_t index);

Description: Set bit value in bit field, treating array pointer as beginning position of the bit field. Bit index is calculated from that position. First byte has index values from 0 to 7. Second byte starts from 8 index and so on.

Parameters:

• array - pointer to array
• index - bit position. First bit has zero index.

Return value: None.

Reset bit value in bit field

C
Unsigned integer types
void Array_ResetBit_uint8 (uint8_t array[], size_t index);
void Array_ResetBit_uint16 (uint16_t array[], size_t index);
void Array_ResetBit_uint32 (uint32_t array[], size_t index);
void Array_ResetBit_uint64 (uint64_t array[], size_t index);

Signed integer types
void Array_ResetBit_sint8 (sint8_t array[], size_t index);
void Array_ResetBit_sint16 (sint16_t array[], size_t index);
void Array_ResetBit_sint32 (sint32_t array[], size_t index);
void Array_ResetBit_sint64 (sint64_t array[], size_t index);

Other types
void Array_ResetBit_size (size_t array[], size_t index);
void Array_ResetBit (void *array, size_t index);

C++
Unsigned integer types
void Array::ResetBit (uint8_t array[], size_t index);
void Array::ResetBit (uint16_t array[], size_t index);
void Array::ResetBit (uint32_t array[], size_t index);
void Array::ResetBit (uint64_t array[], size_t index);

Signed integer types
void Array::ResetBit (sint8_t array[], size_t index);
void Array::ResetBit (sint16_t array[], size_t index);
void Array::ResetBit (sint32_t array[], size_t index);
void Array::ResetBit (sint64_t array[], size_t index);

Other types
void Array::ResetBit (size_t array[], size_t index);
void Array::ResetBit (void *array, size_t index);

Description: Reset bit value in bit field, treating array pointer as beginning position of the bit field. Bit index is calculated from that position. First byte has index values from 0 to 7. Second byte starts from 8 index and so on.

Parameters:

• array - pointer to array
• index - bit position. First bit has zero index.

Return value: None.

Invert bit value in bit field

C
Unsigned integer types
void Array_InvertBit_uint8 (uint8_t array[], size_t index);
void Array_InvertBit_uint16 (uint16_t array[], size_t index);
void Array_InvertBit_uint32 (uint32_t array[], size_t index);
void Array_InvertBit_uint64 (uint64_t array[], size_t index);

Signed integer types
void Array_InvertBit_sint8 (sint8_t array[], size_t index);
void Array_InvertBit_sint16 (sint16_t array[], size_t index);
void Array_InvertBit_sint32 (sint32_t array[], size_t index);
void Array_InvertBit_sint64 (sint64_t array[], size_t index);

Other types
void Array_InvertBit_size (size_t array[], size_t index);
void Array_InvertBit (void *array, size_t index);

C++
Unsigned integer types
void Array::InvertBit (uint8_t array[], size_t index);
void Array::InvertBit (uint16_t array[], size_t index);
void Array::InvertBit (uint32_t array[], size_t index);
void Array::InvertBit (uint64_t array[], size_t index);

Signed integer types
void Array::InvertBit (sint8_t array[], size_t index);
void Array::InvertBit (sint16_t array[], size_t index);
void Array::InvertBit (sint32_t array[], size_t index);
void Array::InvertBit (sint64_t array[], size_t index);

Other types
void Array::InvertBit (size_t array[], size_t index);
void Array::InvertBit (void *array, size_t index);

Description: Invert bit value in bit field, treating array pointer as beginning position of the bit field. Bit index is calculated from that position. First byte has index values from 0 to 7. Second byte starts from 8 index and so on.

Parameters:

• array - pointer to array
• index - bit position. First bit has zero index.

Return value: None.

Bitwise operations

Bitwise operations operate on one or more bit patterns or binary numerals at the level of their individual bits. They work with arrays, applying the same operation to all elements.

Byte swap

C
Unsigned integer types
void Array_ByteSwap_uint8 (uint8_t array[], size_t size);
void Array_ByteSwap_uint16 (uint16_t array[], size_t size);
void Array_ByteSwap_uint32 (uint32_t array[], size_t size);
void Array_ByteSwap_uint64 (uint64_t array[], size_t size);

Signed integer types
void Array_ByteSwap_sint8 (sint8_t array[], size_t size);
void Array_ByteSwap_sint16 (sint16_t array[], size_t size);
void Array_ByteSwap_sint32 (sint32_t array[], size_t size);
void Array_ByteSwap_sint64 (sint64_t array[], size_t size);

Other types
void Array_ByteSwap_size (size_t array[], size_t size);

C++
Unsigned integer types
void Array::ByteSwap (uint8_t array[], size_t size);
void Array::ByteSwap (uint16_t array[], size_t size);
void Array::ByteSwap (uint32_t array[], size_t size);
void Array::ByteSwap (uint64_t array[], size_t size);

Signed integer types
void Array::ByteSwap (sint8_t array[], size_t size);
void Array::ByteSwap (sint16_t array[], size_t size);
void Array::ByteSwap (sint32_t array[], size_t size);
void Array::ByteSwap (sint64_t array[], size_t size);

Other types
void Array::ByteSwap (size_t array[], size_t size);

Description: Reverse bytes order of each array element. This function is provided for converting little-endian values to big-endian format and vice versa.

Parameters:

• array - pointer to array
• size - size of array (count of elements)

Return value: None.

Bit reversal permutation

C
Unsigned integer types
void Array_BitReverse_uint8 (uint8_t array[], size_t size);
void Array_BitReverse_uint16 (uint16_t array[], size_t size);
void Array_BitReverse_uint32 (uint32_t array[], size_t size);
void Array_BitReverse_uint64 (uint64_t array[], size_t size);

Signed integer types
void Array_BitReverse_sint8 (sint8_t array[], size_t size);
void Array_BitReverse_sint16 (sint16_t array[], size_t size);
void Array_BitReverse_sint32 (sint32_t array[], size_t size);
void Array_BitReverse_sint64 (sint64_t array[], size_t size);

Other types
void Array_BitReverse_size (size_t array[], size_t size);

C++
Unsigned integer types
void Array::BitReverse (uint8_t array[], size_t size);
void Array::BitReverse (uint16_t array[], size_t size);
void Array::BitReverse (uint32_t array[], size_t size);
void Array::BitReverse (uint64_t array[], size_t size);

Signed integer types
void Array::BitReverse (sint8_t array[], size_t size);
void Array::BitReverse (sint16_t array[], size_t size);
void Array::BitReverse (sint32_t array[], size_t size);
void Array::BitReverse (sint64_t array[], size_t size);

Other types
void Array::BitReverse (size_t array[], size_t size);

Description: Reverse bits order of each array element and store the result with reversed bits order into the same element.

Parameters:

• array - pointer to array
• size - size of array (count of elements)

Return value: None.

Population count

C
Unsigned integer types
void Array_PopCount_uint8 (uint8_t array[], size_t size);
void Array_PopCount_uint16 (uint16_t array[], size_t size);
void Array_PopCount_uint32 (uint32_t array[], size_t size);
void Array_PopCount_uint64 (uint64_t array[], size_t size);

Signed integer types
void Array_PopCount_sint8 (sint8_t array[], size_t size);
void Array_PopCount_sint16 (sint16_t array[], size_t size);
void Array_PopCount_sint32 (sint32_t array[], size_t size);
void Array_PopCount_sint64 (sint64_t array[], size_t size);

Other types
void Array_PopCount_size (size_t array[], size_t size);

C++
Unsigned integer types
void Array::PopCount (uint8_t array[], size_t size);
void Array::PopCount (uint16_t array[], size_t size);
void Array::PopCount (uint32_t array[], size_t size);
void Array::PopCount (uint64_t array[], size_t size);

Signed integer types
void Array::PopCount (sint8_t array[], size_t size);
void Array::PopCount (sint16_t array[], size_t size);
void Array::PopCount (sint32_t array[], size_t size);
void Array::PopCount (sint64_t array[], size_t size);

Other types
void Array::PopCount (size_t array[], size_t size);

Description: Calculate a number of bits set to 1 in each array element and store calculated value into the same array element.

Parameters:

• array - pointer to array
• size - size of array (count of elements)

Return value: None.

Bitwise NOT

C
Unsigned integer types
void Array_Not_uint8 (uint8_t array[], size_t size);
void Array_Not_uint16 (uint16_t array[], size_t size);
void Array_Not_uint32 (uint32_t array[], size_t size);
void Array_Not_uint64 (uint64_t array[], size_t size);

Signed integer types
void Array_Not_sint8 (sint8_t array[], size_t size);
void Array_Not_sint16 (sint16_t array[], size_t size);
void Array_Not_sint32 (sint32_t array[], size_t size);
void Array_Not_sint64 (sint64_t array[], size_t size);

Other types
void Array_Not_size (size_t array[], size_t size);

C++
Unsigned integer types
void Array::Not (uint8_t array[], size_t size);
void Array::Not (uint16_t array[], size_t size);
void Array::Not (uint32_t array[], size_t size);
void Array::Not (uint64_t array[], size_t size);

Signed integer types
void Array::Not (sint8_t array[], size_t size);
void Array::Not (sint16_t array[], size_t size);
void Array::Not (sint32_t array[], size_t size);
void Array::Not (sint64_t array[], size_t size);

Other types
void Array::Not (size_t array[], size_t size);

Description: Perform logical negation on each bit of array element, forming the ones complement of the given binary value.

Parameters:

• array - pointer to array
• size - size of array (count of elements)

Return value: None.

Bitwise AND

Scalar bitwise AND

C
Unsigned integer types
void Array_AndScalar_uint8 (uint8_t array[], size_t size, uint8_t value);
void Array_AndScalar_uint16 (uint16_t array[], size_t size, uint16_t value);
void Array_AndScalar_uint32 (uint32_t array[], size_t size, uint32_t value);
void Array_AndScalar_uint64 (uint64_t array[], size_t size, uint64_t value);

Signed integer types
void Array_AndScalar_sint8 (sint8_t array[], size_t size, sint8_t value);
void Array_AndScalar_sint16 (sint16_t array[], size_t size, sint16_t value);
void Array_AndScalar_sint32 (sint32_t array[], size_t size, sint32_t value);
void Array_AndScalar_sint64 (sint64_t array[], size_t size, sint64_t value);

Other types
void Array_AndScalar_size (size_t array[], size_t size, size_t value);

C++
Unsigned integer types
void Array::AndScalar (uint8_t array[], size_t size, uint8_t value);
void Array::AndScalar (uint16_t array[], size_t size, uint16_t value);
void Array::AndScalar (uint32_t array[], size_t size, uint32_t value);
void Array::AndScalar (uint64_t array[], size_t size, uint64_t value);

Signed integer types
void Array::AndScalar (sint8_t array[], size_t size, sint8_t value);
void Array::AndScalar (sint16_t array[], size_t size, sint16_t value);
void Array::AndScalar (sint32_t array[], size_t size, sint32_t value);
void Array::AndScalar (sint64_t array[], size_t size, sint64_t value);

Other types
void Array::AndScalar (size_t array[], size_t size, size_t value);

Description: Perform the logical AND operation on each pair of corresponding bits of array element and the value, then store result to target array elements.

Parameters:

• array - pointer to array
• size - size of array (count of elements)
• value - value to operate with

Return value: None.

Vector bitwise AND

C
Unsigned integer types
void Array_AndVector_uint8 (uint8_t target[], const uint8_t source[], size_t size);
void Array_AndVector_uint16 (uint16_t target[], const uint16_t source[], size_t size);
void Array_AndVector_uint32 (uint32_t target[], const uint32_t source[], size_t size);
void Array_AndVector_uint64 (uint64_t target[], const uint64_t source[], size_t size);

Signed integer types
void Array_AndVector_sint8 (sint8_t target[], const sint8_t source[], size_t size);
void Array_AndVector_sint16 (sint16_t target[], const sint16_t source[], size_t size);
void Array_AndVector_sint32 (sint32_t target[], const sint32_t source[], size_t size);
void Array_AndVector_sint64 (sint64_t target[], const sint64_t source[], size_t size);

Other types
void Array_AndVector_size (size_t target[], const size_t source[], size_t size);

C++
Unsigned integer types
void Array::AndVector (uint8_t target[], const uint8_t source[], size_t size);
void Array::AndVector (uint16_t target[], const uint16_t source[], size_t size);
void Array::AndVector (uint32_t target[], const uint32_t source[], size_t size);
void Array::AndVector (uint64_t target[], const uint64_t source[], size_t size);

Signed integer types
void Array::AndVector (sint8_t target[], const sint8_t source[], size_t size);
void Array::AndVector (sint16_t target[], const sint16_t source[], size_t size);
void Array::AndVector (sint32_t target[], const sint32_t source[], size_t size);
void Array::AndVector (sint64_t target[], const sint64_t source[], size_t size);

Other types
void Array::AndVector (size_t target[], const size_t source[], size_t size);

Description: Perform the logical AND operation on each pair of corresponding bits of array elements, and store result to target array elements.

Parameters:

• target - pointer to target array
• source - pointer to source array
• size - size of arrays (count of elements)

Return value: None.

Warning:If arrays are overlapped in memory, then content of the source array will be unexpectedly modified, and content of the target array will be also undefined.

Bitwise OR

Scalar bitwise OR

C
Unsigned integer types
void Array_OrScalar_uint8 (uint8_t array[], size_t size, uint8_t value);
void Array_OrScalar_uint16 (uint16_t array[], size_t size, uint16_t value);
void Array_OrScalar_uint32 (uint32_t array[], size_t size, uint32_t value);
void Array_OrScalar_uint64 (uint64_t array[], size_t size, uint64_t value);

Signed integer types
void Array_OrScalar_sint8 (sint8_t array[], size_t size, sint8_t value);
void Array_OrScalar_sint16 (sint16_t array[], size_t size, sint16_t value);
void Array_OrScalar_sint32 (sint32_t array[], size_t size, sint32_t value);
void Array_OrScalar_sint64 (sint64_t array[], size_t size, sint64_t value);

Other types
void Array_OrScalar_size (size_t array[], size_t size, size_t value);

C++
Unsigned integer types
void Array::OrScalar (uint8_t array[], size_t size, uint8_t value);
void Array::OrScalar (uint16_t array[], size_t size, uint16_t value);
void Array::OrScalar (uint32_t array[], size_t size, uint32_t value);
void Array::OrScalar (uint64_t array[], size_t size, uint64_t value);

Signed integer types
void Array::OrScalar (sint8_t array[], size_t size, sint8_t value);
void Array::OrScalar (sint16_t array[], size_t size, sint16_t value);
void Array::OrScalar (sint32_t array[], size_t size, sint32_t value);
void Array::OrScalar (sint64_t array[], size_t size, sint64_t value);

Other types
void Array::OrScalar (size_t array[], size_t size, size_t value);

Description: Perform the logical inclusive OR operation on each pair of corresponding bits of array element and the value, then store result to target array elements.

Parameters:

• array - pointer to array
• size - size of array (count of elements)
• value - value to operate with

Return value: None.

Vector bitwise OR

C
Unsigned integer types
void Array_OrVector_uint8 (uint8_t target[], const uint8_t source[], size_t size);
void Array_OrVector_uint16 (uint16_t target[], const uint16_t source[], size_t size);
void Array_OrVector_uint32 (uint32_t target[], const uint32_t source[], size_t size);
void Array_OrVector_uint64 (uint64_t target[], const uint64_t source[], size_t size);

Signed integer types
void Array_OrVector_sint8 (sint8_t target[], const sint8_t source[], size_t size);
void Array_OrVector_sint16 (sint16_t target[], const sint16_t source[], size_t size);
void Array_OrVector_sint32 (sint32_t target[], const sint32_t source[], size_t size);
void Array_OrVector_sint64 (sint64_t target[], const sint64_t source[], size_t size);

Other types
void Array_OrVector_size (size_t target[], const size_t source[], size_t size);

C++
Unsigned integer types
void Array::OrVector (uint8_t target[], const uint8_t source[], size_t size);
void Array::OrVector (uint16_t target[], const uint16_t source[], size_t size);
void Array::OrVector (uint32_t target[], const uint32_t source[], size_t size);
void Array::OrVector (uint64_t target[], const uint64_t source[], size_t size);

Signed integer types
void Array::OrVector (sint8_t target[], const sint8_t source[], size_t size);
void Array::OrVector (sint16_t target[], const sint16_t source[], size_t size);
void Array::OrVector (sint32_t target[], const sint32_t source[], size_t size);
void Array::OrVector (sint64_t target[], const sint64_t source[], size_t size);

Other types
void Array::OrVector (size_t target[], const size_t source[], size_t size);

Description: Perform the logical inclusive OR operation on each pair of corresponding bits of array elements, and store result to target array elements.

Parameters:

• target - pointer to target array
• source - pointer to source array
• size - size of arrays (count of elements)

Return value: None.

Warning:If arrays are overlapped in memory, then content of the source array will be unexpectedly modified, and content of the target array will be also undefined.

Bitwise XOR

Scalar bitwise XOR

C
Unsigned integer types
void Array_XorScalar_uint8 (uint8_t array[], size_t size, uint8_t value);
void Array_XorScalar_uint16 (uint16_t array[], size_t size, uint16_t value);
void Array_XorScalar_uint32 (uint32_t array[], size_t size, uint32_t value);
void Array_XorScalar_uint64 (uint64_t array[], size_t size, uint64_t value);

Signed integer types
void Array_XorScalar_sint8 (sint8_t array[], size_t size, sint8_t value);
void Array_XorScalar_sint16 (sint16_t array[], size_t size, sint16_t value);
void Array_XorScalar_sint32 (sint32_t array[], size_t size, sint32_t value);
void Array_XorScalar_sint64 (sint64_t array[], size_t size, sint64_t value);

Other types
void Array_XorScalar_size (size_t array[], size_t size, size_t value);

C++
Unsigned integer types
void Array::XorScalar (uint8_t array[], size_t size, uint8_t value);
void Array::XorScalar (uint16_t array[], size_t size, uint16_t value);
void Array::XorScalar (uint32_t array[], size_t size, uint32_t value);
void Array::XorScalar (uint64_t array[], size_t size, uint64_t value);

Signed integer types
void Array::XorScalar (sint8_t array[], size_t size, sint8_t value);
void Array::XorScalar (sint16_t array[], size_t size, sint16_t value);
void Array::XorScalar (sint32_t array[], size_t size, sint32_t value);
void Array::XorScalar (sint64_t array[], size_t size, sint64_t value);

Other types
void Array::XorScalar (size_t array[], size_t size, size_t value);

Description: Perform the logical exclusive OR operation on each pair of corresponding bits of array element and the value, then store result to target array elements.

Parameters:

• array - pointer to array
• size - size of array (count of elements)
• value - value to operate with

Return value: None.

Vector bitwise XOR

C
Unsigned integer types
void Array_XorVector_uint8 (uint8_t target[], const uint8_t source[], size_t size);
void Array_XorVector_uint16 (uint16_t target[], const uint16_t source[], size_t size);
void Array_XorVector_uint32 (uint32_t target[], const uint32_t source[], size_t size);
void Array_XorVector_uint64 (uint64_t target[], const uint64_t source[], size_t size);

Signed integer types
void Array_XorVector_sint8 (sint8_t target[], const sint8_t source[], size_t size);
void Array_XorVector_sint16 (sint16_t target[], const sint16_t source[], size_t size);
void Array_XorVector_sint32 (sint32_t target[], const sint32_t source[], size_t size);
void Array_XorVector_sint64 (sint64_t target[], const sint64_t source[], size_t size);

Other types
void Array_XorVector_size (size_t target[], const size_t source[], size_t size);

C++
Unsigned integer types
void Array::XorVector (uint8_t target[], const uint8_t source[], size_t size);
void Array::XorVector (uint16_t target[], const uint16_t source[], size_t size);
void Array::XorVector (uint32_t target[], const uint32_t source[], size_t size);
void Array::XorVector (uint64_t target[], const uint64_t source[], size_t size);

Signed integer types
void Array::XorVector (sint8_t target[], const sint8_t source[], size_t size);
void Array::XorVector (sint16_t target[], const sint16_t source[], size_t size);
void Array::XorVector (sint32_t target[], const sint32_t source[], size_t size);
void Array::XorVector (sint64_t target[], const sint64_t source[], size_t size);

Other types
void Array::XorVector (size_t target[], const size_t source[], size_t size);

Description: Perform the logical exclusive OR operation on each pair of corresponding bits of array elements, and store result to target array elements.

Parameters:

• target - pointer to target array
• source - pointer to source array
• size - size of arrays (count of elements)

Return value: None.

Warning:If arrays are overlapped in memory, then content of the source array will be unexpectedly modified, and content of the target array will be also undefined.

Arithmetic operations

These functions provide regular arithmetic operations, which operate on array elements. They have the same functionality as typical C++ operators, but apply them to each element of arrays, using SIMD instructions.

Unary operations

Unary array operations use the same array as the source and destination point for data storage. They provide wide used unary arithmetic operations and mathematical functions for arrays.

Negative value

C
Signed integer types
void Array_Neg_sint8 (sint8_t array[], size_t size);
void Array_Neg_sint16 (sint16_t array[], size_t size);
void Array_Neg_sint32 (sint32_t array[], size_t size);
void Array_Neg_sint64 (sint64_t array[], size_t size);

Floating-point types
void Array_Neg_flt32 (flt32_t array[], size_t size);
void Array_Neg_flt64 (flt64_t array[], size_t size);

C++
Signed integer types
void Array::Neg (sint8_t array[], size_t size);
void Array::Neg (sint16_t array[], size_t size);
void Array::Neg (sint32_t array[], size_t size);
void Array::Neg (sint64_t array[], size_t size);

Floating-point types
void Array::Neg (flt32_t array[], size_t size);
void Array::Neg (flt64_t array[], size_t size);

Description: Change sign of each array element.

Parameters:

• array - pointer to array
• size - size of array (count of elements)

Return value: None.

Absolute value

C
Signed integer types
void Array_Abs_sint8 (sint8_t array[], size_t size);
void Array_Abs_sint16 (sint16_t array[], size_t size);
void Array_Abs_sint32 (sint32_t array[], size_t size);
void Array_Abs_sint64 (sint64_t array[], size_t size);

Floating-point types
void Array_Abs_flt32 (flt32_t array[], size_t size);
void Array_Abs_flt64 (flt64_t array[], size_t size);

C++
Signed integer types
void Array::Abs (sint8_t array[], size_t size);
void Array::Abs (sint16_t array[], size_t size);
void Array::Abs (sint32_t array[], size_t size);
void Array::Abs (sint64_t array[], size_t size);

Floating-point types
void Array::Abs (flt32_t array[], size_t size);
void Array::Abs (flt64_t array[], size_t size);

Description: Compute absolute value of each array element, and store it into the same element.

Parameters:

• array - pointer to array
• size - size of array (count of elements)

Return value: None.

Negative absolute value

C
Signed integer types
void Array_NegAbs_sint8 (sint8_t array[], size_t size);
void Array_NegAbs_sint16 (sint16_t array[], size_t size);
void Array_NegAbs_sint32 (sint32_t array[], size_t size);
void Array_NegAbs_sint64 (sint64_t array[], size_t size);

Floating-point types
void Array_NegAbs_flt32 (flt32_t array[], size_t size);
void Array_NegAbs_flt64 (flt64_t array[], size_t size);

C++
Signed integer types
void Array::NegAbs (sint8_t array[], size_t size);
void Array::NegAbs (sint16_t array[], size_t size);
void Array::NegAbs (sint32_t array[], size_t size);
void Array::NegAbs (sint64_t array[], size_t size);

Floating-point types
void Array::NegAbs (flt32_t array[], size_t size);
void Array::NegAbs (flt64_t array[], size_t size);

Description: Compute negative absolute value of each array element, and store it into the same element.

Parameters:

• array - pointer to array
• size - size of array (count of elements)

Return value: None.

Number sign

C
Signed integer types
void Array_Sign_sint8 (sint8_t array[], size_t size);
void Array_Sign_sint16 (sint16_t array[], size_t size);
void Array_Sign_sint32 (sint32_t array[], size_t size);
void Array_Sign_sint64 (sint64_t array[], size_t size);

Floating-point types
void Array_Sign_flt32 (flt32_t array[], size_t size);
void Array_Sign_flt64 (flt64_t array[], size_t size);

C++
Signed integer types
void Array::Sign (sint8_t array[], size_t size);
void Array::Sign (sint16_t array[], size_t size);
void Array::Sign (sint32_t array[], size_t size);
void Array::Sign (sint64_t array[], size_t size);

Floating-point types
void Array::Sign (flt32_t array[], size_t size);
void Array::Sign (flt64_t array[], size_t size);

Description: Compute sign of each array element, and store it into the same element. If element is positive, then +1 is returned. If element is negative, then -1 is returned. If element is zero, then zero is returned. If element is NaN (not a number), then NaN is also returned.

Parameters:

• array - pointer to array
• size - size of array (count of elements)

Return value: None.

Square

Cvoid Array_Sqr_flt32 (flt32_t array[], size_t size);
void Array_Sqr_flt64 (flt64_t array[], size_t size);

C++void Array::Sqr (flt32_t array[], size_t size);
void Array::Sqr (flt64_t array[], size_t size);

Description: Compute square value of each array element, and store it into the same element.

Parameters:

• array - pointer to array
• size - size of array (count of elements)

Return value: None.

Square root

Cvoid Array_Sqrt_flt32 (flt32_t array[], size_t size);
void Array_Sqrt_flt64 (flt64_t array[], size_t size);

C++void Array::Sqrt (flt32_t array[], size_t size);
void Array::Sqrt (flt64_t array[], size_t size);

Description: Compute square root value of each array element, and store it into the same element.

Parameters:

• array - pointer to array
• size - size of array (count of elements)

Return value: None.

Binary operations

Binary array operations use both source and target arrays as the data source. They provide wide used binary arithmetic operations for arrays, and store the result to target array.

Addition

Addition functions do arithmetic addition between corresponding array elements or between array element and variable, and store result to target array elements.

Scalar additiontop

C
Unsigned integer types
void Array_AddScalar_uint8 (uint8_t array[], size_t size, uint8_t value);
void Array_AddScalar_uint16 (uint16_t array[], size_t size, uint16_t value);
void Array_AddScalar_uint32 (uint32_t array[], size_t size, uint32_t value);
void Array_AddScalar_uint64 (uint64_t array[], size_t size, uint64_t value);

Signed integer types
void Array_AddScalar_sint8 (sint8_t array[], size_t size, sint8_t value);
void Array_AddScalar_sint16 (sint16_t array[], size_t size, sint16_t value);
void Array_AddScalar_sint32 (sint32_t array[], size_t size, sint32_t value);
void Array_AddScalar_sint64 (sint64_t array[], size_t size, sint64_t value);

Floating-point types
void Array_AddScalar_flt32 (flt32_t array[], size_t size, flt32_t value);
void Array_AddScalar_flt64 (flt64_t array[], size_t size, flt64_t value);

Other types
void Array_AddScalar_size (size_t array[], size_t size, size_t value);

C++
Unsigned integer types
void Array::AddScalar (uint8_t array[], size_t size, uint8_t value);
void Array::AddScalar (uint16_t array[], size_t size, uint16_t value);
void Array::AddScalar (uint32_t array[], size_t size, uint32_t value);
void Array::AddScalar (uint64_t array[], size_t size, uint64_t value);

Signed integer types
void Array::AddScalar (sint8_t array[], size_t size, sint8_t value);
void Array::AddScalar (sint16_t array[], size_t size, sint16_t value);
void Array::AddScalar (sint32_t array[], size_t size, sint32_t value);
void Array::AddScalar (sint64_t array[], size_t size, sint64_t value);

Floating-point types
void Array::AddScalar (flt32_t array[], size_t size, flt32_t value);
void Array::AddScalar (flt64_t array[], size_t size, flt64_t value);

Other types
void Array::AddScalar (size_t array[], size_t size, size_t value);

Description: Add specified value to each array element, and store result to the same element.

Parameters:

• array - pointer to array
• size - size of array (count of elements)
• value - value to add

Return value: None.

Vector additiontop

C
void Array_AddVector_uint8 (uint8_t target[], const uint8_t source[], size_t size);
void Array_AddVector_uint16 (uint16_t target[], const uint16_t source[], size_t size);
void Array_AddVector_uint32 (uint32_t target[], const uint32_t source[], size_t size);
void Array_AddVector_uint64 (uint64_t target[], const uint64_t source[], size_t size);

Signed integer types
void Array_AddVector_sint8 (sint8_t target[], const sint8_t source[], size_t size);
void Array_AddVector_sint16 (sint16_t target[], const sint16_t source[], size_t size);
void Array_AddVector_sint32 (sint32_t target[], const sint32_t source[], size_t size);
void Array_AddVector_sint64 (sint64_t target[], const sint64_t source[], size_t size);

Floating-point types
void Array_AddVector_flt32 (flt32_t target[], const flt32_t source[], size_t size);
void Array_AddVector_flt64 (flt64_t target[], const flt64_t source[], size_t size);

Other types
void Array_AddVector_size (size_t target[], const size_t source[], size_t size);

C++
Unsigned integer types
void Array::AddVector (uint8_t target[], const uint8_t source[], size_t size);
void Array::AddVector (uint16_t target[], const uint16_t source[], size_t size);
void Array::AddVector (uint32_t target[], const uint32_t source[], size_t size);
void Array::AddVector (uint64_t target[], const uint64_t source[], size_t size);

Signed integer types
void Array::AddVector (sint8_t target[], const sint8_t source[], size_t size);
void Array::AddVector (sint16_t target[], const sint16_t source[], size_t size);
void Array::AddVector (sint32_t target[], const sint32_t source[], size_t size);
void Array::AddVector (sint64_t target[], const sint64_t source[], size_t size);

Floating-point types
void Array::AddVector (flt32_t target[], const flt32_t source[], size_t size);
void Array::AddVector (flt64_t target[], const flt64_t source[], size_t size);

Other types
void Array::AddVector (size_t target[], const size_t source[], size_t size);

Description: Perform the arithmetic addition operation on each pair of corresponding array elements, and store result to target array elements.

Parameters:

• target - pointer to target array
• source - pointer to source array
• size - size of arrays (count of elements)

Return value: None.

Warning:If arrays are overlapped in memory, then content of the source array will be unexpectedly modified, and content of the target array will be also undefined.

Subtraction

Subtraction functions do arithmetic subtraction between corresponding array elements or between array element and variable, and store result to target array elements.

Scalar subtractiontop

C
Unsigned integer types
void Array_SubScalar_uint8 (uint8_t array[], size_t size, uint8_t value);
void Array_SubScalar_uint16 (uint16_t array[], size_t size, uint16_t value);
void Array_SubScalar_uint32 (uint32_t array[], size_t size, uint32_t value);
void Array_SubScalar_uint64 (uint64_t array[], size_t size, uint64_t value);

Signed integer types
void Array_SubScalar_sint8 (sint8_t array[], size_t size, sint8_t value);
void Array_SubScalar_sint16 (sint16_t array[], size_t size, sint16_t value);
void Array_SubScalar_sint32 (sint32_t array[], size_t size, sint32_t value);
void Array_SubScalar_sint64 (sint64_t array[], size_t size, sint64_t value);

Floating-point types
void Array_SubScalar_flt32 (flt32_t array[], size_t size, flt32_t value);
void Array_SubScalar_flt64 (flt64_t array[], size_t size, flt64_t value);

Other types
void Array_SubScalar_size (size_t array[], size_t size, size_t value);

C++
Unsigned integer types
void Array::SubScalar (uint8_t array[], size_t size, uint8_t value);
void Array::SubScalar (uint16_t array[], size_t size, uint16_t value);
void Array::SubScalar (uint32_t array[], size_t size, uint32_t value);
void Array::SubScalar (uint64_t array[], size_t size, uint64_t value);

Signed integer types
void Array::SubScalar (sint8_t array[], size_t size, sint8_t value);
void Array::SubScalar (sint16_t array[], size_t size, sint16_t value);
void Array::SubScalar (sint32_t array[], size_t size, sint32_t value);
void Array::SubScalar (sint64_t array[], size_t size, sint64_t value);

Floating-point types
void Array::SubScalar (flt32_t array[], size_t size, flt32_t value);
void Array::SubScalar (flt64_t array[], size_t size, flt64_t value);

Other types
void Array::SubScalar (size_t array[], size_t size, size_t value);

Description: Subtract specified value from each array element, and store result to the same element.

Parameters:

• array - pointer to array
• size - size of array (count of elements)
• value - value to subtract

Return value: None.

Vector subtractiontop

C
void Array_SubVector_uint8 (uint8_t target[], const uint8_t source[], size_t size);
void Array_SubVector_uint16 (uint16_t target[], const uint16_t source[], size_t size);
void Array_SubVector_uint32 (uint32_t target[], const uint32_t source[], size_t size);
void Array_SubVector_uint64 (uint64_t target[], const uint64_t source[], size_t size);

Signed integer types
void Array_SubVector_sint8 (sint8_t target[], const sint8_t source[], size_t size);
void Array_SubVector_sint16 (sint16_t target[], const sint16_t source[], size_t size);
void Array_SubVector_sint32 (sint32_t target[], const sint32_t source[], size_t size);
void Array_SubVector_sint64 (sint64_t target[], const sint64_t source[], size_t size);

Floating-point types
void Array_SubVector_flt32 (flt32_t target[], const flt32_t source[], size_t size);
void Array_SubVector_flt64 (flt64_t target[], const flt64_t source[], size_t size);

Other types
void Array_SubVector_size (size_t target[], const size_t source[], size_t size);

C++
Unsigned integer types
void Array::SubVector (uint8_t target[], const uint8_t source[], size_t size);
void Array::SubVector (uint16_t target[], const uint16_t source[], size_t size);
void Array::SubVector (uint32_t target[], const uint32_t source[], size_t size);
void Array::SubVector (uint64_t target[], const uint64_t source[], size_t size);

Signed integer types
void Array::SubVector (sint8_t target[], const sint8_t source[], size_t size);
void Array::SubVector (sint16_t target[], const sint16_t source[], size_t size);
void Array::SubVector (sint32_t target[], const sint32_t source[], size_t size);
void Array::SubVector (sint64_t target[], const sint64_t source[], size_t size);

Floating-point types
void Array::SubVector (flt32_t target[], const flt32_t source[], size_t size);
void Array::SubVector (flt64_t target[], const flt64_t source[], size_t size);

Other types
void Array::SubVector (size_t target[], const size_t source[], size_t size);

Description: Perform the arithmetic subtraction operation on each pair of corresponding array elements, and store result to target array elements.

Parameters:

• target - pointer to target array
• source - pointer to source array
• size - size of arrays (count of elements)

Return value: None.

Warning:If arrays are overlapped in memory, then content of the source array will be unexpectedly modified, and content of the target array will be also undefined.

Reverse subtraction

Reverse subtraction functions do arithmetic subtraction in reverse order between corresponding array elements or between array element and variable, and store result to target array elements.

Scalar reverse subtractiontop

C
Unsigned integer types
void Array_ReverseSubScalar_uint8 (uint8_t array[], size_t size, uint8_t value);
void Array_ReverseSubScalar_uint16 (uint16_t array[], size_t size, uint16_t value);
void Array_ReverseSubScalar_uint32 (uint32_t array[], size_t size, uint32_t value);
void Array_ReverseSubScalar_uint64 (uint64_t array[], size_t size, uint64_t value);

Signed integer types
void Array_ReverseSubScalar_sint8 (sint8_t array[], size_t size, sint8_t value);
void Array_ReverseSubScalar_sint16 (sint16_t array[], size_t size, sint16_t value);
void Array_ReverseSubScalar_sint32 (sint32_t array[], size_t size, sint32_t value);
void Array_ReverseSubScalar_sint64 (sint64_t array[], size_t size, sint64_t value);

Floating-point types
void Array_ReverseSubScalar_flt32 (flt32_t array[], size_t size, flt32_t value);
void Array_ReverseSubScalar_flt64 (flt64_t array[], size_t size, flt64_t value);

Other types
void Array_ReverseSubScalar_size (size_t array[], size_t size, size_t value);

C++
Unsigned integer types
void Array::ReverseSubScalar (uint8_t array[], size_t size, uint8_t value);
void Array::ReverseSubScalar (uint16_t array[], size_t size, uint16_t value);
void Array::ReverseSubScalar (uint32_t array[], size_t size, uint32_t value);
void Array::ReverseSubScalar (uint64_t array[], size_t size, uint64_t value);

Signed integer types
void Array::ReverseSubScalar (sint8_t array[], size_t size, sint8_t value);
void Array::ReverseSubScalar (sint16_t array[], size_t size, sint16_t value);
void Array::ReverseSubScalar (sint32_t array[], size_t size, sint32_t value);
void Array::ReverseSubScalar (sint64_t array[], size_t size, sint64_t value);

Floating-point types
void Array::ReverseSubScalar (flt32_t array[], size_t size, flt32_t value);
void Array::ReverseSubScalar (flt64_t array[], size_t size, flt64_t value);

Other types
void Array::ReverseSubScalar (size_t array[], size_t size, size_t value);

Description: Subtract each array element from specified value, and store result to the same element.

Parameters:

• array - pointer to array
• size - size of array (count of elements)
• value - value to subtract from

Return value: None.

Vector reverse subtractiontop

C
void Array_ReverseSubVector_uint8 (uint8_t target[], const uint8_t source[], size_t size);
void Array_ReverseSubVector_uint16 (uint16_t target[], const uint16_t source[], size_t size);
void Array_ReverseSubVector_uint32 (uint32_t target[], const uint32_t source[], size_t size);
void Array_ReverseSubVector_uint64 (uint64_t target[], const uint64_t source[], size_t size);

Signed integer types
void Array_ReverseSubVector_sint8 (sint8_t target[], const sint8_t source[], size_t size);
void Array_ReverseSubVector_sint16 (sint16_t target[], const sint16_t source[], size_t size);
void Array_ReverseSubVector_sint32 (sint32_t target[], const sint32_t source[], size_t size);
void Array_ReverseSubVector_sint64 (sint64_t target[], const sint64_t source[], size_t size);

Floating-point types
void Array_ReverseSubVector_flt32 (flt32_t target[], const flt32_t source[], size_t size);
void Array_ReverseSubVector_flt64 (flt64_t target[], const flt64_t source[], size_t size);

Other types
void Array_ReverseSubVector_size (size_t target[], const size_t source[], size_t size);

C++
Unsigned integer types
void Array::ReverseSubVector (uint8_t target[], const uint8_t source[], size_t size);
void Array::ReverseSubVector (uint16_t target[], const uint16_t source[], size_t size);
void Array::ReverseSubVector (uint32_t target[], const uint32_t source[], size_t size);
void Array::ReverseSubVector (uint64_t target[], const uint64_t source[], size_t size);

Signed integer types
void Array::ReverseSubVector (sint8_t target[], const sint8_t source[], size_t size);
void Array::ReverseSubVector (sint16_t target[], const sint16_t source[], size_t size);
void Array::ReverseSubVector (sint32_t target[], const sint32_t source[], size_t size);
void Array::ReverseSubVector (sint64_t target[], const sint64_t source[], size_t size);

Floating-point types
void Array::ReverseSubVector (flt32_t target[], const flt32_t source[], size_t size);
void Array::ReverseSubVector (flt64_t target[], const flt64_t source[], size_t size);

Other types
void Array::ReverseSubVector (size_t target[], const size_t source[], size_t size);

Description: Perform the reverse arithmetic subtraction operation on each pair of corresponding array elements, and store result to target array elements.

Parameters:

• target - pointer to target array
• source - pointer to source array
• size - size of arrays (count of elements)

Return value: None.

Warning:If arrays are overlapped in memory, then content of the source array will be unexpectedly modified, and content of the target array will be also undefined.

Multiplication

Multiplication functions do arithmetic multiplication between corresponding array elements or between array element and variable, and store result to target array elements.

Scalar multiplicationtop

Cvoid Array_MulScalar_flt32 (flt32_t array[], size_t size, flt32_t value);
void Array_MulScalar_flt64 (flt64_t array[], size_t size, flt64_t value);

C++void Array::MulScalar (flt32_t array[], size_t size, flt32_t value);
void Array::MulScalar (flt64_t array[], size_t size, flt64_t value);

Description: Multiply each array element to specified value, and store result to the same element.

Parameters:

• array - pointer to array
• size - size of array (count of elements)
• value - value to multiply

Return value: None.

Vector multiplicationtop

Cvoid Array_MulVector_flt32 (flt32_t target[], const flt32_t source[], size_t size);
void Array_MulVector_flt64 (flt64_t target[], const flt64_t source[], size_t size);

C++void Array::MulVector (flt32_t target[], const flt32_t source[], size_t size);
void Array::MulVector (flt64_t target[], const flt64_t source[], size_t size);

Description: Perform the arithmetic multiplication operation on each pair of corresponding array elements, and store result to target array elements.

Parameters:

• target - pointer to target array
• source - pointer to source array
• size - size of arrays (count of elements)

Return value: None.

Warning:If arrays are overlapped in memory, then content of the source array will be unexpectedly modified, and content of the target array will be also undefined.

Division

Division functions do arithmetic division between corresponding array elements or between array element and variable, and store result to target array elements.

Scalar divisiontop

Cvoid Array_DivScalar_flt32 (flt32_t array[], size_t size, flt32_t value);
void Array_DivScalar_flt64 (flt64_t array[], size_t size, flt64_t value);

C++void Array::DivScalar (flt32_t array[], size_t size, flt32_t value);
void Array::DivScalar (flt64_t array[], size_t size, flt64_t value);

Description: Divide each array element to specified value, and store result to the same element.

Parameters:

• array - pointer to array
• size - size of array (count of elements)
• value - value to divide

Return value: None.

Vector divisiontop

Cvoid Array_DivVector_flt32 (flt32_t target[], const flt32_t source[], size_t size);
void Array_DivVector_flt64 (flt64_t target[], const flt64_t source[], size_t size);

C++void Array::DivVector (flt32_t target[], const flt32_t source[], size_t size);
void Array::DivVector (flt64_t target[], const flt64_t source[], size_t size);

Description: Perform the arithmetic division operation on each pair of corresponding array elements, and store result to target array elements.

Parameters:

• target - pointer to target array
• source - pointer to source array
• size - size of arrays (count of elements)

Return value: None.

Warning:If arrays are overlapped in memory, then content of the source array will be unexpectedly modified, and content of the target array will be also undefined.

Reverse division

Reverse division functions do arithmetic division in reverse order between corresponding array elements or between array element and variable, and store result to target array elements.

Scalar reverse divisiontop

Cvoid Array_ReverseDivScalar_flt32 (flt32_t array[], size_t size, flt32_t value);
void Array_ReverseDivScalar_flt64 (flt64_t array[], size_t size, flt64_t value);

C++void Array::ReverseDivScalar (flt32_t array[], size_t size, flt32_t value);
void Array::ReverseDivScalar (flt64_t array[], size_t size, flt64_t value);

Description: Divide specified value to each array element, and store result to the same element.

Parameters:

• array - pointer to array
• size - size of array (count of elements)
• value - value to be divided

Return value: None.

Vector reverse divisiontop

Cvoid Array_ReverseDivVector_flt32 (flt32_t target[], const flt32_t source[], size_t size);
void Array_ReverseDivVector_flt64 (flt64_t target[], const flt64_t source[], size_t size);

C++void Array::ReverseDivVector (flt32_t target[], const flt32_t source[], size_t size);
void Array::ReverseDivVector (flt64_t target[], const flt64_t source[], size_t size);

Description: Perform the reverse arithmetic division operation on each pair of corresponding array elements, and store result to target array elements.

Parameters:

• target - pointer to target array
• source - pointer to source array
• size - size of arrays (count of elements)

Return value: None.

Warning:If arrays are overlapped in memory, then content of the source array will be unexpectedly modified, and content of the target array will be also undefined.

Rounding

Round down (floor)

Cvoid Array_RoundDown_flt32 (flt32_t array[], size_t size);
void Array_RoundDown_flt64 (flt64_t array[], size_t size);

C++void Array::RoundDown (flt32_t array[], size_t size);
void Array::RoundDown (flt64_t array[], size_t size);

Description: Round all array elements to an integer values in floating-point format, using round down (floor) mode.

Parameters:

• array - pointer to array
• size - size of array (count of elements)

Return value: None.

Round up (ceil)

Cvoid Array_RoundUp_flt32 (flt32_t array[], size_t size);
void Array_RoundUp_flt64 (flt64_t array[], size_t size);

C++void Array::RoundUp (flt32_t array[], size_t size);
void Array::RoundUp (flt64_t array[], size_t size);

Description: Round all array elements to an integer values in floating-point format, using round up (ceil) mode.

Parameters:

• array - pointer to array
• size - size of array (count of elements)

Return value: None.

Round to nearest even integer

Cvoid Array_RoundInt_flt32 (flt32_t array[], size_t size);
void Array_RoundInt_flt64 (flt64_t array[], size_t size);

C++void Array::RoundInt (flt32_t array[], size_t size);
void Array::RoundInt (flt64_t array[], size_t size);

Description: Round all array elements to an integer values in floating-point format, using round to nearest even integer mode.

Parameters:

• array - pointer to array
• size - size of array (count of elements)

Return value: None.

Round to nearest integer, away from zero

Cvoid Array_Round_flt32 (flt32_t array[], size_t size);
void Array_Round_flt64 (flt64_t array[], size_t size);

C++void Array::Round (flt32_t array[], size_t size);
void Array::Round (flt64_t array[], size_t size);

Description: Round all array elements to an integer values in floating-point format, using round to nearest integer, away from zero mode.

Parameters:

• array - pointer to array
• size - size of array (count of elements)

Return value: None.

Round to nearest integer, toward zero (truncation)

Cvoid Array_Truncate_flt32 (flt32_t array[], size_t size);
void Array_Truncate_flt64 (flt64_t array[], size_t size);

C++void Array::Truncate (flt32_t array[], size_t size);
void Array::Truncate (flt64_t array[], size_t size);

Description: Round all array elements to an integer values in floating-point format, using round to nearest integer, toward zero (truncation) mode.

Parameters:

• array - pointer to array
• size - size of array (count of elements)

Return value: None.

Fractional part

Cvoid Array_Frac_flt32 (flt32_t array[], size_t size);
void Array_Frac_flt64 (flt64_t array[], size_t size);

C++void Array::Frac (flt32_t array[], size_t size);
void Array::Frac (flt64_t array[], size_t size);

Description: Extract fractional part of array elements and store them into the same array.

Parameters:

• array - pointer to array
• size - size of array (count of elements)

Return value: None.

Numerical integration

Numerical integration is a broad family of algorithms for calculating the numerical value of a definite integral. The functions below use values of array elements as values of some function, and find different types of definite integral from that function.

Sum of elements

Cflt32_t Array_Sum_flt32 (const flt32_t array[], size_t size);
flt64_t Array_Sum_flt64 (const flt64_t array[], size_t size);

C++flt32_t Array::Sum (const flt32_t array[], size_t size);
flt64_t Array::Sum (const flt64_t array[], size_t size);

Description: Compute sum of all array elements.

Parameters:

• array - pointer to array
• size - size of array (count of elements)

Return value:

• Sum of all array elements.
• 0 (zero) if array size is zero.
• NaN (not a number) if any element of array has NaN value.

Sum of squares

Cflt32_t Array_SumSqr_flt32 (const flt32_t array[], size_t size);
flt64_t Array_SumSqr_flt64 (const flt64_t array[], size_t size);

C++flt32_t Array::SumSqr (const flt32_t array[], size_t size);
flt64_t Array::SumSqr (const flt64_t array[], size_t size);

Description: Compute sum of squares of all array elements.

Parameters:

• array - pointer to array
• size - size of array (count of elements)

Return value:

• Sum of squares of all array elements.
• 0 (zero) if array size is zero.
• NaN (not a number) if any element of array has NaN value.

Sum of absolute values

Cflt32_t Array_SumAbs_flt32 (const flt32_t array[], size_t size);
flt64_t Array_SumAbs_flt64 (const flt64_t array[], size_t size);

C++flt32_t Array::SumAbs (const flt32_t array[], size_t size);
flt64_t Array::SumAbs (const flt64_t array[], size_t size);

Description: Compute sum of absolute values of all array elements.

Parameters:

• array - pointer to array
• size - size of array (count of elements)

Return value:

• Sum of absolute values of all array elements.
• 0 (zero) if array size is zero.
• NaN (not a number) if any element of array has NaN value.

‬Sum of multiplied values

Cflt32_t Array_SumMul_flt32 (const flt32_t array1[], const flt32_t array2[], size_t size);
flt64_t Array_SumMul_flt64 (const flt64_t array1[], const flt64_t array2[], size_t size);

C++flt32_t Array::SumMul (const flt32_t array1[], const flt32_t array2[], size_t size);
flt64_t Array::SumMul (const flt64_t array1[], const flt64_t array2[], size_t size);

Description: Multiply each pair of corresponding array elements and accumulate sum of products.

Parameters:

• array1 - pointer to first array
• array2 - pointer to second array
• size - size of arrays (count of elements)

Return value:

• Sum of multiplied values of corresponding array elements.
• 0 (zero) if array size is zero.
• NaN (not a number) if any element of array has NaN value.

Sum of squared differences

Cflt32_t Array_SumSqrDiff_flt32 (const flt32_t array1[], const flt32_t array2[], size_t size);
flt64_t Array_SumSqrDiff_flt64 (const flt64_t array1[], const flt64_t array2[], size_t size);

C++flt32_t Array::SumSqrDiff (const flt32_t array1[], const flt32_t array2[], size_t size);
flt64_t Array::SumSqrDiff (const flt64_t array1[], const flt64_t array2[], size_t size);

Description: Compute square of difference of each pair of corresponding array elements and accumulate sum of squares.

Parameters:

• array1 - pointer to first array
• array2 - pointer to second array
• size - size of arrays (count of elements)

Return value:

• Sum of squared differences of corresponding array elements.
• 0 (zero) if arrays size is zero.
• NaN (not a number) if any element of arrays has NaN value.

Sum of absolute differences

Cflt32_t Array_SumAbsDiff_flt32 (const flt32_t array1[], const flt32_t array2[], size_t size);
flt64_t Array_SumAbsDiff_flt64 (const flt64_t array1[], const flt64_t array2[], size_t size);

C++flt32_t Array::SumAbsDiff (const flt32_t array1[], const flt32_t array2[], size_t size);
flt64_t Array::SumAbsDiff (const flt64_t array1[], const flt64_t array2[], size_t size);

Description: Compute absolute value of difference of each pair of corresponding array elements and accumulate sum of absolute values.

Parameters:

• array1 - pointer to first array
• array2 - pointer to second array
• size - size of arrays (count of elements)

Return value:

• Sum of absolute differences of corresponding array elements.
• 0 (zero) if arrays size is zero.
• NaN (not a number) if any element of arrays has NaN value.

Minimum and maximum absolute value

Min/Max functions scan array elements for minimum and maximum absolute value, then return it as the function result. If any element of array has NaN value, then NaN value is returned.

Minimum absolute value

C
Signed integer types
uint8_t Array_MinAbs_sint8 (const sint8_t array[], size_t size);
uint16_t Array_MinAbs_sint16 (const sint16_t array[], size_t size);
uint32_t Array_MinAbs_sint32 (const sint32_t array[], size_t size);

Floating-point types
flt32_t Array_MinAbs_flt32 (const flt32_t array[], size_t size);
flt64_t Array_MinAbs_flt64 (const flt64_t array[], size_t size);

C++
Signed integer types
uint8_t Array::MinAbs (const sint8_t array[], size_t size);
uint16_t Array::MinAbs (const sint16_t array[], size_t size);
uint32_t Array::MinAbs (const sint32_t array[], size_t size);

Floating-point types
flt32_t Array::MinAbs (const flt32_t array[], size_t size);
flt64_t Array::MinAbs (const flt64_t array[], size_t size);

Description: Find minimum absolute value among all array elements.

Parameters:

• array - pointer to array
• size - size of array (count of elements)

Return value:

• Element which has minimum absolute value, ignoring its sign (ie sign is cleared).
• 0 (zero) if size of integer array is equal to zero.
• NaN (not a number) if array size is zero, or array has NaN values.

Maximum absolute value

C
Signed integer types
uint8_t Array_MaxAbs_sint8 (const sint8_t array[], size_t size);
uint16_t Array_MaxAbs_sint16 (const sint16_t array[], size_t size);
uint32_t Array_MaxAbs_sint32 (const sint32_t array[], size_t size);

Floating-point types
flt32_t Array_MaxAbs_flt32 (const flt32_t array[], size_t size);
flt64_t Array_MaxAbs_flt64 (const flt64_t array[], size_t size);

C++
Signed integer types
uint8_t Array::MaxAbs (const sint8_t array[], size_t size);
uint16_t Array::MaxAbs (const sint16_t array[], size_t size);
uint32_t Array::MaxAbs (const sint32_t array[], size_t size);

Floating-point types
flt32_t Array::MaxAbs (const flt32_t array[], size_t size);
flt64_t Array::MaxAbs (const flt64_t array[], size_t size);

Description: Find maximum absolute value among all array elements.

Parameters:

• array - pointer to array
• size - size of array (count of elements)

Return value:

• Element which has maximum absolute value, ignoring its sign (ie sign is cleared).
• 0 (zero) if size of integer array is equal to zero.
• NaN (not a number) if array size is zero, or array has NaN values.

Minimum and maximum value

Min/Max functions scan array elements for minimum and maximum value. They can scan regular and object arrays. Functions return min or max value or an index of first/last element which has min or max value.

Regular array search

Following min/max functions scan regular arrays for minimum and maximum values and return such value as the result. If any element of array has NaN value, then NaN value is returned.

Minimum value

C
Unsigned integer types
uint8_t Array_Min_uint8 (const uint8_t array[], size_t size);
uint16_t Array_Min_uint16 (const uint16_t array[], size_t size);
uint32_t Array_Min_uint32 (const uint32_t array[], size_t size);

Signed integer types
sint8_t Array_Min_sint8 (const sint8_t array[], size_t size);
sint16_t Array_Min_sint16 (const sint16_t array[], size_t size);
sint32_t Array_Min_sint32 (const sint32_t array[], size_t size);

Floating-point types
flt32_t Array_Min_flt32 (const flt32_t array[], size_t size);
flt64_t Array_Min_flt64 (const flt64_t array[], size_t size);

C++
Unsigned integer types
uint8_t Array::Min (const uint8_t array[], size_t size);
uint16_t Array::Min (const uint16_t array[], size_t size);
uint32_t Array::Min (const uint32_t array[], size_t size);

Signed integer types
sint8_t Array::Min (const sint8_t array[], size_t size);
sint16_t Array::Min (const sint16_t array[], size_t size);
sint32_t Array::Min (const sint32_t array[], size_t size);

Floating-point types
flt32_t Array::Min (const flt32_t array[], size_t size);
flt64_t Array::Min (const flt64_t array[], size_t size);

Description: Find minimum value among all array elements.

Parameters:

• array - pointer to array
• size - size of array (count of elements)

Return value:

• Minimum value of array.
• 0 (zero) if size of integer array is equal to zero.
• NaN (not a number) if size of floating-point array is equal to zero, or array has NaN values.

Maximum value

C
Unsigned integer types
uint8_t Array_Max_uint8 (const uint8_t array[], size_t size);
uint16_t Array_Max_uint16 (const uint16_t array[], size_t size);
uint32_t Array_Max_uint32 (const uint32_t array[], size_t size);

Signed integer types
sint8_t Array_Max_sint8 (const sint8_t array[], size_t size);
sint16_t Array_Max_sint16 (const sint16_t array[], size_t size);
sint32_t Array_Max_sint32 (const sint32_t array[], size_t size);

Floating-point types
flt32_t Array_Max_flt32 (const flt32_t array[], size_t size);
flt64_t Array_Max_flt64 (const flt64_t array[], size_t size);

C++
Unsigned integer types
uint8_t Array::Max (const uint8_t array[], size_t size);
uint16_t Array::Max (const uint16_t array[], size_t size);
uint32_t Array::Max (const uint32_t array[], size_t size);

Signed integer types
sint8_t Array::Max (const sint8_t array[], size_t size);
sint16_t Array::Max (const sint16_t array[], size_t size);
sint32_t Array::Max (const sint32_t array[], size_t size);

Floating-point types
flt32_t Array::Max (const flt32_t array[], size_t size);
flt64_t Array::Max (const flt64_t array[], size_t size);

Description: Find maximum value among all array elements.

Parameters:

• array - pointer to array
• size - size of array (count of elements)

Return value:

• Maximum value of array.
• 0 (zero) if size of integer array is equal to zero.
• NaN (not a number) if size of floating-point array is equal to zero, or array has NaN values.

Object array search

These functions scan array of objects for minimum and maximum object value from first to last element and vice versa. Then they return an index of first/last element which has min or max value.

Minimum value

Csize_t Array_MinObjFwd (const void* array[], size_t size, Cmp func);
size_t Array_MinObjBwd (const void* array[], size_t size, Cmp func);

C++size_t Array::MinObjFwd (const void* array[], size_t size, Cmp func);
size_t Array::MinObjBwd (const void* array[], size_t size, Cmp func);

Description: Find first/last minimum value among all array elements.

Parameters:

• array - pointer to array of pointers to objects
• size - size of array (count of elements)
• func - pointer to a key compare function. Compare function should follow this prototype.

Return value:

• Index of first/last minimum object into array.
• -1 if object array is empty.

Maximum value

Csize_t Array_MaxObjFwd (const void* array[], size_t size, Cmp func);
size_t Array_MaxObjBwd (const void* array[], size_t size, Cmp func);

C++size_t Array::MaxObjFwd (const void* array[], size_t size, Cmp func);
size_t Array::MaxObjBwd (const void* array[], size_t size, Cmp func);

Description: Find first/last maximum value among all array elements.

Parameters:

• array - pointer to array of pointers to objects
• size - size of array (count of elements)
• func - pointer to a key compare function. Compare function should follow this prototype.

Return value:

• Index of first/last maximum object into array.
• -1 if object array is empty.

Linear search

Linear search algorithms find position of a specified value within regular arrays. These arrays usually are not sorted. For sorted arrays use binary searching algorithms, which are the best for this kind of arrays.

Bit field search

Bit field search functions treat array as continuous bit bield, which stores sequence of independent bits. Each bit does not correspond with its neighbors, but only indicates some state, which can be set (1) or reset (0). Search functions scan bit fields in both forward and backward directions for set or reset bits and return index of first/last bit which conform search condition.

Forward direction search

These functions scan bit field in forward direction for first set or reset bit. They check only specified range of bits starting from spos to epos (epos bit is the first bit outside the search range). Index of first found bit is returned as the function result.

Searching for set bittop

C
Unsigned integer types
size_t Array_FindSetBitFwd_uint8 (const uint8_t array[], size_t spos, size_t epos);
size_t Array_FindSetBitFwd_uint16 (const uint16_t array[], size_t spos, size_t epos);
size_t Array_FindSetBitFwd_uint32 (const uint32_t array[], size_t spos, size_t epos);
size_t Array_FindSetBitFwd_uint64 (const uint64_t array[], size_t spos, size_t epos);

Signed integer types
size_t Array_FindSetBitFwd_sint8 (const sint8_t array[], size_t spos, size_t epos);
size_t Array_FindSetBitFwd_sint16 (const sint16_t array[], size_t spos, size_t epos);
size_t Array_FindSetBitFwd_sint32 (const sint32_t array[], size_t spos, size_t epos);
size_t Array_FindSetBitFwd_sint64 (const sint64_t array[], size_t spos, size_t epos);

Other types
size_t Array_FindSetBitFwd_size (const size_t array[], size_t spos, size_t epos);
size_t Array_FindSetBitFwd (const void *array, size_t spos, size_t epos);

C++
Unsigned integer types
size_t Array::FindSetBitFwd (const uint8_t array[], size_t spos, size_t epos);
size_t Array::FindSetBitFwd (const uint16_t array[], size_t spos, size_t epos);
size_t Array::FindSetBitFwd (const uint32_t array[], size_t spos, size_t epos);
size_t Array::FindSetBitFwd (const uint64_t array[], size_t spos, size_t epos);

Signed integer types
size_t Array::FindSetBitFwd (const sint8_t array[], size_t spos, size_t epos);
size_t Array::FindSetBitFwd (const sint16_t array[], size_t spos, size_t epos);
size_t Array::FindSetBitFwd (const sint32_t array[], size_t spos, size_t epos);
size_t Array::FindSetBitFwd (const sint64_t array[], size_t spos, size_t epos);

Other types
size_t Array::FindSetBitFwd (const size_t array[], size_t spos, size_t epos);
size_t Array::FindSetBitFwd (const void *array, size_t spos, size_t epos);

Description: Search bit field in range [spos,epos) in forward direction for set bit and return position of first set bit, treating array pointer as beginning position of the bit field. Bit index is calculated from that position. First byte has index values from 0 to 7. Second byte starts from 8 index and so on.

Parameters:

• array - pointer to array
• spos - bit position from where to start bit searching
• epos - bit position where to stop bit searching (first bit outside the search range)

Return value:

• An index of first set bit.
• -1 if bit range has no set bits.

Searching for reset bittop

C
Unsigned integer types
size_t Array_FindResetBitFwd_uint8 (const uint8_t array[], size_t spos, size_t epos);
size_t Array_FindResetBitFwd_uint16 (const uint16_t array[], size_t spos, size_t epos);
size_t Array_FindResetBitFwd_uint32 (const uint32_t array[], size_t spos, size_t epos);
size_t Array_FindResetBitFwd_uint64 (const uint64_t array[], size_t spos, size_t epos);

Signed integer types
size_t Array_FindResetBitFwd_sint8 (const sint8_t array[], size_t spos, size_t epos);
size_t Array_FindResetBitFwd_sint16 (const sint16_t array[], size_t spos, size_t epos);
size_t Array_FindResetBitFwd_sint32 (const sint32_t array[], size_t spos, size_t epos);
size_t Array_FindResetBitFwd_sint64 (const sint64_t array[], size_t spos, size_t epos);

Other types
size_t Array_FindResetBitFwd_size (const size_t array[], size_t spos, size_t epos);
size_t Array_FindResetBitFwd (const void *array, size_t spos, size_t epos);

C++
Unsigned integer types
size_t Array::FindResetBitFwd (const uint8_t array[], size_t spos, size_t epos);
size_t Array::FindResetBitFwd (const uint16_t array[], size_t spos, size_t epos);
size_t Array::FindResetBitFwd (const uint32_t array[], size_t spos, size_t epos);
size_t Array::FindResetBitFwd (const uint64_t array[], size_t spos, size_t epos);

Signed integer types
size_t Array::FindResetBitFwd (const sint8_t array[], size_t spos, size_t epos);
size_t Array::FindResetBitFwd (const sint16_t array[], size_t spos, size_t epos);
size_t Array::FindResetBitFwd (const sint32_t array[], size_t spos, size_t epos);
size_t Array::FindResetBitFwd (const sint64_t array[], size_t spos, size_t epos);

Other types
size_t Array::FindResetBitFwd (const size_t array[], size_t spos, size_t epos);
size_t Array::FindResetBitFwd (const void *array, size_t spos, size_t epos);

Description: Search bit field in range [spos,epos) in forward direction for reset bit and return position of first reset bit, treating array pointer as beginning position of the bit field. Bit index is calculated from that position. First byte has index values from 0 to 7. Second byte starts from 8 index and so on.

Parameters:

• array - pointer to array
• spos - bit position from where to start bit searching
• epos - bit position where to stop bit searching (first bit outside the search range)

Return value:

• An index of first reset bit.
• -1 if bit range has no reset bits.

Backward direction search

These functions scan bit field in backward direction for last set or reset bit. They check only specified range of bits starting from spos to epos (epos bit is the first bit outside the search range). Index of last found bit is returned as the function result.

Searching for set bittop

C
Unsigned integer types
size_t Array_FindSetBitBwd_uint8 (const uint8_t array[], size_t spos, size_t epos);
size_t Array_FindSetBitBwd_uint16 (const uint16_t array[], size_t spos, size_t epos);
size_t Array_FindSetBitBwd_uint32 (const uint32_t array[], size_t spos, size_t epos);
size_t Array_FindSetBitBwd_uint64 (const uint64_t array[], size_t spos, size_t epos);

Signed integer types
size_t Array_FindSetBitBwd_sint8 (const sint8_t array[], size_t spos, size_t epos);
size_t Array_FindSetBitBwd_sint16 (const sint16_t array[], size_t spos, size_t epos);
size_t Array_FindSetBitBwd_sint32 (const sint32_t array[], size_t spos, size_t epos);
size_t Array_FindSetBitBwd_sint64 (const sint64_t array[], size_t spos, size_t epos);

Other types
size_t Array_FindSetBitBwd_size (const size_t array[], size_t spos, size_t epos);
size_t Array_FindSetBitBwd (const void *array, size_t spos, size_t epos);

C++
Unsigned integer types
size_t Array::FindSetBitBwd (const uint8_t array[], size_t spos, size_t epos);
size_t Array::FindSetBitBwd (const uint16_t array[], size_t spos, size_t epos);
size_t Array::FindSetBitBwd (const uint32_t array[], size_t spos, size_t epos);
size_t Array::FindSetBitBwd (const uint64_t array[], size_t spos, size_t epos);

Signed integer types
size_t Array::FindSetBitBwd (const sint8_t array[], size_t spos, size_t epos);
size_t Array::FindSetBitBwd (const sint16_t array[], size_t spos, size_t epos);
size_t Array::FindSetBitBwd (const sint32_t array[], size_t spos, size_t epos);
size_t Array::FindSetBitBwd (const sint64_t array[], size_t spos, size_t epos);

Other types
size_t Array::FindSetBitBwd (const size_t array[], size_t spos, size_t epos);
size_t Array::FindSetBitBwd (const void *array, size_t spos, size_t epos);

Description: Search bit field in range [spos,epos) in backward direction for set bit and return position of last set bit, treating array pointer as beginning position of the bit field. Bit index is calculated from that position. First byte has index values from 0 to 7. Second byte starts from 8 index and so on.

Parameters:

• array - pointer to array
• spos - bit position from where to start bit searching
• epos - bit position where to stop bit searching (first bit outside the search range)

Return value:

• An index of last set bit.
• -1 if bit range has no set bits.

Searching for reset bittop

C
Unsigned integer types
size_t Array_FindResetBitBwd_uint8 (const uint8_t array[], size_t spos, size_t epos);
size_t Array_FindResetBitBwd_uint16 (const uint16_t array[], size_t spos, size_t epos);
size_t Array_FindResetBitBwd_uint32 (const uint32_t array[], size_t spos, size_t epos);
size_t Array_FindResetBitBwd_uint64 (const uint64_t array[], size_t spos, size_t epos);

Signed integer types
size_t Array_FindResetBitBwd_sint8 (const sint8_t array[], size_t spos, size_t epos);
size_t Array_FindResetBitBwd_sint16 (const sint16_t array[], size_t spos, size_t epos);
size_t Array_FindResetBitBwd_sint32 (const sint32_t array[], size_t spos, size_t epos);
size_t Array_FindResetBitBwd_sint64 (const sint64_t array[], size_t spos, size_t epos);

Other types
size_t Array_FindResetBitBwd_size (const size_t array[], size_t spos, size_t epos);
size_t Array_FindResetBitBwd (const void *array, size_t spos, size_t epos);

C++
Unsigned integer types
size_t Array::FindResetBitBwd (const uint8_t array[], size_t spos, size_t epos);
size_t Array::FindResetBitBwd (const uint16_t array[], size_t spos, size_t epos);
size_t Array::FindResetBitBwd (const uint32_t array[], size_t spos, size_t epos);
size_t Array::FindResetBitBwd (const uint64_t array[], size_t spos, size_t epos);

Signed integer types
size_t Array::FindResetBitBwd (const sint8_t array[], size_t spos, size_t epos);
size_t Array::FindResetBitBwd (const sint16_t array[], size_t spos, size_t epos);
size_t Array::FindResetBitBwd (const sint32_t array[], size_t spos, size_t epos);
size_t Array::FindResetBitBwd (const sint64_t array[], size_t spos, size_t epos);

Other types
size_t Array::FindResetBitBwd (const size_t array[], size_t spos, size_t epos);
size_t Array::FindResetBitBwd (const void *array, size_t spos, size_t epos);

Description: Search bit field in range [spos,epos) in backward direction for reset bit and return position of last reset bit, treating array pointer as beginning position of the bit field. Bit index is calculated from that position. First byte has index values from 0 to 7. Second byte starts from 8 index and so on.

Parameters:

• array - pointer to array
• spos - bit position from where to start bit searching
• epos - bit position where to stop bit searching (first bit outside the search range)

Return value:

• An index of last reset bit.
• -1 if bit range has no reset bits.

Regular array search

Next functions search regular array in forward and backward direction for the element which is equal to the specified value and return an index of first or last occurrence of the element in the array.

Forward direction search

C
Unsigned integer types
size_t Array_FindFwd_uint8 (const uint8_t array[], size_t size, uint8_t value);
size_t Array_FindFwd_uint16 (const uint16_t array[], size_t size, uint16_t value);
size_t Array_FindFwd_uint32 (const uint32_t array[], size_t size, uint32_t value);
size_t Array_FindFwd_uint64 (const uint64_t array[], size_t size, uint64_t value);

Signed integer types
size_t Array_FindFwd_sint8 (const sint8_t array[], size_t size, sint8_t value);
size_t Array_FindFwd_sint16 (const sint16_t array[], size_t size, sint16_t value);
size_t Array_FindFwd_sint32 (const sint32_t array[], size_t size, sint32_t value);
size_t Array_FindFwd_sint64 (const sint64_t array[], size_t size, sint64_t value);

Other types
size_t Array_FindFwd_size (const size_t array[], size_t size, size_t value);

C++
Unsigned integer types
size_t Array::FindFwd (const uint8_t array[], size_t size, uint8_t value);
size_t Array::FindFwd (const uint16_t array[], size_t size, uint16_t value);
size_t Array::FindFwd (const uint32_t array[], size_t size, uint32_t value);
size_t Array::FindFwd (const uint64_t array[], size_t size, uint64_t value);

Signed integer types
size_t Array::FindFwd (const sint8_t array[], size_t size, sint8_t value);
size_t Array::FindFwd (const sint16_t array[], size_t size, sint16_t value);
size_t Array::FindFwd (const sint32_t array[], size_t size, sint32_t value);
size_t Array::FindFwd (const sint64_t array[], size_t size, sint64_t value);

Other types
size_t Array::FindFwd (const size_t array[], size_t size, size_t value);

Description: Search array in forward direction for specified value and return index of its first occurrence.

Parameters:

• array - pointer to array
• size - size of array (count of elements)
• value - value to find

Return value:

• An index of first occurrence of specified value.
• -1 if the element was not found.

Backward direction search

C
Unsigned integer types
size_t Array_FindBwd_uint8 (const uint8_t array[], size_t size, uint8_t value);
size_t Array_FindBwd_uint16 (const uint16_t array[], size_t size, uint16_t value);
size_t Array_FindBwd_uint32 (const uint32_t array[], size_t size, uint32_t value);
size_t Array_FindBwd_uint64 (const uint64_t array[], size_t size, uint64_t value);

Signed integer types
size_t Array_FindBwd_sint8 (const sint8_t array[], size_t size, sint8_t value);
size_t Array_FindBwd_sint16 (const sint16_t array[], size_t size, sint16_t value);
size_t Array_FindBwd_sint32 (const sint32_t array[], size_t size, sint32_t value);
size_t Array_FindBwd_sint64 (const sint64_t array[], size_t size, sint64_t value);

Other types
size_t Array_FindBwd_size (const size_t array[], size_t size, size_t value);

C++
Unsigned integer types
size_t Array::FindBwd (const uint8_t array[], size_t size, uint8_t value);
size_t Array::FindBwd (const uint16_t array[], size_t size, uint16_t value);
size_t Array::FindBwd (const uint32_t array[], size_t size, uint32_t value);
size_t Array::FindBwd (const uint64_t array[], size_t size, uint64_t value);

Signed integer types
size_t Array::FindBwd (const sint8_t array[], size_t size, sint8_t value);
size_t Array::FindBwd (const sint16_t array[], size_t size, sint16_t value);
size_t Array::FindBwd (const sint32_t array[], size_t size, sint32_t value);
size_t Array::FindBwd (const sint64_t array[], size_t size, sint64_t value);

Other types
size_t Array::FindBwd (const size_t array[], size_t size, size_t value);

Description: Search array in backward direction for specified value and return index of its last occurrence.

Parameters:

• array - pointer to array
• size - size of array (count of elements)
• value - value to find

Return value:

• An index of last occurrence of specified value.
• -1 if the element was not found.

Object array search

Next functions search array of objects in forward and backward direction for the element which is equal to the specified value and return an index of first or last occurrence of the element in the array.

Forward direction search

Csize_t Array_FindObjFwd (const void* array[], size_t size, const void *value, Cmp func);

C++size_t Array::FindObjFwd (const void* array[], size_t size, const void *value, Cmp func);

Description: Search array in forward direction for specified value and return index of its first occurrence.

Parameters:

• array - pointer to array of pointers to objects
• size - size of array (count of elements)
• value - pointer to value to find
• func - pointer to a key compare function. Compare function should follow this prototype.

Return value:

• An index of first occurrence of specified value.
• -1 if the element was not found.

Backward direction search

Csize_t Array_FindObjBwd (const void* array[], size_t size, const void *value, Cmp func);

C++size_t Array::FindObjBwd (const void* array[], size_t size, const void *value, Cmp func);

Description: Search array in backward direction for specified value and return index of its last occurrence.

Parameters:

• array - pointer to array of pointers to objects
• size - size of array (count of elements)
• value - pointer to value to find
• func - pointer to a key compare function. Compare function should follow this prototype.

Return value:

• An index of last occurrence of specified value.
• -1 if the element was not found.

Binary search

Binary search algorithms find position of a specified value within a sorted array. Arrays may be sorted in ascending or descending order. Functions can be used to find elements which conform to special conditions like equal, less, great etc. They return index of first/last position of element which met the condition.

Regular array search

Next functions check regular array, which is sorted in ascending or descending order, for the element, which is conform to the specified condition, and return an index of first or last occurrence of the matched element in the array.

Ascending sort order

Searching for first equal elementtop

C
Unsigned integer types
size_t Array_FindFirstEqualAsc_uint8 (const uint8_t array[], size_t size, uint8_t value);
size_t Array_FindFirstEqualAsc_uint16 (const uint16_t array[], size_t size, uint16_t value);
size_t Array_FindFirstEqualAsc_uint32 (const uint32_t array[], size_t size, uint32_t value);
size_t Array_FindFirstEqualAsc_uint64 (const uint64_t array[], size_t size, uint64_t value);

Signed integer types
size_t Array_FindFirstEqualAsc_sint8 (const sint8_t array[], size_t size, sint8_t value);
size_t Array_FindFirstEqualAsc_sint16 (const sint16_t array[], size_t size, sint16_t value);
size_t Array_FindFirstEqualAsc_sint32 (const sint32_t array[], size_t size, sint32_t value);
size_t Array_FindFirstEqualAsc_sint64 (const sint64_t array[], size_t size, sint64_t value);

Other types
size_t Array_FindFirstEqualAsc_size (const size_t array[], size_t size, size_t value);

C++
Unsigned integer types
size_t Array::FindFirstEqualAsc (const uint8_t array[], size_t size, uint8_t value);
size_t Array::FindFirstEqualAsc (const uint16_t array[], size_t size, uint16_t value);
size_t Array::FindFirstEqualAsc (const uint32_t array[], size_t size, uint32_t value);
size_t Array::FindFirstEqualAsc (const uint64_t array[], size_t size, uint64_t value);

Signed integer types
size_t Array::FindFirstEqualAsc (const sint8_t array[], size_t size, sint8_t value);
size_t Array::FindFirstEqualAsc (const sint16_t array[], size_t size, sint16_t value);
size_t Array::FindFirstEqualAsc (const sint32_t array[], size_t size, sint32_t value);
size_t Array::FindFirstEqualAsc (const sint64_t array[], size_t size, sint64_t value);

Other types
size_t Array::FindFirstEqualAsc (const size_t array[], size_t size, size_t value);

Description: Search the array, which is sorted in ascending order for specified value and return index of its first occurrence.

Parameters:

• array - pointer to array
• size - size of array (count of elements)
• value - value to process

Return value:

• An index of first occurrence of specified value.
• -1 if element was not found.

Note:These functions work only with sorted arrays. To use them with unordered arrays they should be sorted first.

Searching for last equal elementtop

C
Unsigned integer types
size_t Array_FindLastEqualAsc_uint8 (const uint8_t array[], size_t size, uint8_t value);
size_t Array_FindLastEqualAsc_uint16 (const uint16_t array[], size_t size, uint16_t value);
size_t Array_FindLastEqualAsc_uint32 (const uint32_t array[], size_t size, uint32_t value);
size_t Array_FindLastEqualAsc_uint64 (const uint64_t array[], size_t size, uint64_t value);

Signed integer types
size_t Array_FindLastEqualAsc_sint8 (const sint8_t array[], size_t size, sint8_t value);
size_t Array_FindLastEqualAsc_sint16 (const sint16_t array[], size_t size, sint16_t value);
size_t Array_FindLastEqualAsc_sint32 (const sint32_t array[], size_t size, sint32_t value);
size_t Array_FindLastEqualAsc_sint64 (const sint64_t array[], size_t size, sint64_t value);

Other types
size_t Array_FindLastEqualAsc_size (const size_t array[], size_t size, size_t value);

C++
Unsigned integer types
size_t Array::FindLastEqualAsc (const uint8_t array[], size_t size, uint8_t value);
size_t Array::FindLastEqualAsc (const uint16_t array[], size_t size, uint16_t value);
size_t Array::FindLastEqualAsc (const uint32_t array[], size_t size, uint32_t value);
size_t Array::FindLastEqualAsc (const uint64_t array[], size_t size, uint64_t value);

Signed integer types
size_t Array::FindLastEqualAsc (const sint8_t array[], size_t size, sint8_t value);
size_t Array::FindLastEqualAsc (const sint16_t array[], size_t size, sint16_t value);
size_t Array::FindLastEqualAsc (const sint32_t array[], size_t size, sint32_t value);
size_t Array::FindLastEqualAsc (const sint64_t array[], size_t size, sint64_t value);

Other types
size_t Array::FindLastEqualAsc (const size_t array[], size_t size, size_t value);

Description: Search the array, which is sorted in ascending order for specified value and return index of its last occurrence.

Parameters:

• array - pointer to array
• size - size of array (count of elements)
• value - value to process

Return value:

• An index of last occurrence of specified value.
• -1 if element was not found.

Note:These functions work only with sorted arrays. To use them with unordered arrays they should be sorted first.

Searching for greater elementtop

C
Unsigned integer types
size_t Array_FindGreatAsc_uint8 (const uint8_t array[], size_t size, uint8_t value);
size_t Array_FindGreatAsc_uint16 (const uint16_t array[], size_t size, uint16_t value);
size_t Array_FindGreatAsc_uint32 (const uint32_t array[], size_t size, uint32_t value);
size_t Array_FindGreatAsc_uint64 (const uint64_t array[], size_t size, uint64_t value);

Signed integer types
size_t Array_FindGreatAsc_sint8 (const sint8_t array[], size_t size, sint8_t value);
size_t Array_FindGreatAsc_sint16 (const sint16_t array[], size_t size, sint16_t value);
size_t Array_FindGreatAsc_sint32 (const sint32_t array[], size_t size, sint32_t value);
size_t Array_FindGreatAsc_sint64 (const sint64_t array[], size_t size, sint64_t value);

Other types
size_t Array_FindGreatAsc_size (const size_t array[], size_t size, size_t value);

C++
Unsigned integer types
size_t Array::FindGreatAsc (const uint8_t array[], size_t size, uint8_t value);
size_t Array::FindGreatAsc (const uint16_t array[], size_t size, uint16_t value);
size_t Array::FindGreatAsc (const uint32_t array[], size_t size, uint32_t value);
size_t Array::FindGreatAsc (const uint64_t array[], size_t size, uint64_t value);

Signed integer types
size_t Array::FindGreatAsc (const sint8_t array[], size_t size, sint8_t value);
size_t Array::FindGreatAsc (const sint16_t array[], size_t size, sint16_t value);
size_t Array::FindGreatAsc (const sint32_t array[], size_t size, sint32_t value);
size_t Array::FindGreatAsc (const sint64_t array[], size_t size, sint64_t value);

Other types
size_t Array::FindGreatAsc (const size_t array[], size_t size, size_t value);

Description: Search the array, which is sorted in ascending order for the first element, which is greater than the specified value.

Parameters:

• array - pointer to array
• size - size of array (count of elements)
• value - value to process

Return value:

• An index of first element, which is greater than the value.
• -1 if element was not found.

Note:These functions work only with sorted arrays. To use them with unordered arrays they should be sorted first.

Searching for greater or equal elementtop

C
Unsigned integer types
size_t Array_FindGreatOrEqualAsc_uint8 (const uint8_t array[], size_t size, uint8_t value);
size_t Array_FindGreatOrEqualAsc_uint16 (const uint16_t array[], size_t size, uint16_t value);
size_t Array_FindGreatOrEqualAsc_uint32 (const uint32_t array[], size_t size, uint32_t value);
size_t Array_FindGreatOrEqualAsc_uint64 (const uint64_t array[], size_t size, uint64_t value);

Signed integer types
size_t Array_FindGreatOrEqualAsc_sint8 (const sint8_t array[], size_t size, sint8_t value);
size_t Array_FindGreatOrEqualAsc_sint16 (const sint16_t array[], size_t size, sint16_t value);
size_t Array_FindGreatOrEqualAsc_sint32 (const sint32_t array[], size_t size, sint32_t value);
size_t Array_FindGreatOrEqualAsc_sint64 (const sint64_t array[], size_t size, sint64_t value);

Other types
size_t Array_FindGreatOrEqualAsc_size (const size_t array[], size_t size, size_t value);

C++
Unsigned integer types
size_t Array::FindGreatOrEqualAsc (const uint8_t array[], size_t size, uint8_t value);
size_t Array::FindGreatOrEqualAsc (const uint16_t array[], size_t size, uint16_t value);
size_t Array::FindGreatOrEqualAsc (const uint32_t array[], size_t size, uint32_t value);
size_t Array::FindGreatOrEqualAsc (const uint64_t array[], size_t size, uint64_t value);

Signed integer types
size_t Array::FindGreatOrEqualAsc (const sint8_t array[], size_t size, sint8_t value);
size_t Array::FindGreatOrEqualAsc (const sint16_t array[], size_t size, sint16_t value);
size_t Array::FindGreatOrEqualAsc (const sint32_t array[], size_t size, sint32_t value);
size_t Array::FindGreatOrEqualAsc (const sint64_t array[], size_t size, sint64_t value);

Other types
size_t Array::FindGreatOrEqualAsc (const size_t array[], size_t size, size_t value);

Description: Search the array, which is sorted in ascending order for the first element, which is greater than or equal to the specified value.

Parameters:

• array - pointer to array
• size - size of array (count of elements)
• value - value to process

Return value: