memneg_BE_inplace()

bool Chusov::Memory::memneg_BE_inplace ( void *  pData, std::size_t  cbData  )

noexcept

Replaces an arbitrary-precision integer given by a vector of bytes in the Big-Endian order with its additive inversion returning the value of the highest bit of the result.

Parameters

[in,out]	pData	A pointer to a buffer which on input contains the input integer in the Big-Endian byte order. On output, the buffer receives a two's complement of the input integer with respect to 2CHAR_BIT cbData.
	cbData	Size of the integer in bytes.

Returns

A value of the highest bit of the result.

The function considers the input vector to specify the integer in the Big-Endian byte order. That is, given that \(V_X = \{x_0, \dots, x_n\}\) is the input value, such that \(x_0\) is the first byte in memory of the vector, \(x_n\) is the last byte and n = cbData - 1, the input value for the operation is \(X = \sum_{i=0}^{n}x_{n-i}\cdot b^i\), where b = 2CHAR_BIT is a number of values that can be represented with one byte. To negate Little-Endian integers use memneg_LE_inplace.

To produce the result in a separate buffer leaving the original integer unchanged use memneg_BE_copy or memneg_BE.

See also

memneg_BE_copy;
memneg_LE_inplace;
memneg_BE;
memincr_BE;
memdecr_BE;
memadd_BE;
memsub_BE.