Manual Pages  — Q_INI

The Q_NCBITS defined constant specifies the number of reserved control bits, currently 3.

Q_NTBITS(), Q_NFCBITS(), Q_MAXNFBITS(), Q_NFBITS() and Q_NIBITS() return the q, Ns, -specific count of total, control-encoded fractional, maximum fractional, effective fractional, and integer bits applicable to q respectively.

Q_BT() returns the C data type of q, while Q_TC() returns v type casted to the C data type of q.

Q_RPSHFT() returns the bit position of q, Ap, s binary radix point relative to bit zero.

Q_ABS() returns the absolute value of any standard numeric type (that uses the MSB as a sign bit, but not Q numbers) passed in as n. The function is signed/unsigned type safe.

Q_SHL() and Q_SHR() return the integral value v left or right shifted by the appropriate amount for q.

Q_MAXSTRLEN() calculates the maximum number of characters that may be required to render the C-string representation of q with numeric base base.

Q_TOSTR() renders the C-string representation of q with numeric base base and fractional precision prec into s which has an available capacity of slen characters. base must be in range [2,16]. Specifying prec as -1 renders the number's fractional component with maximum precision. If slen is greater than zero but insufficient to hold the complete C-string, the '\0' C-string terminator will be written to *s, thereby returning a zero length C-string.

Q_DEBUG() returns a format string and associated data suitable for printf-like rendering of debugging information pertaining to q. If either prefmt and/or postfmt are specified, they are prepended and appended to the resulting format string respectively. The incfmt boolean specifies whether to include (true) or exclude (false) the raw format string itself in the debugging output.

Q_DFV2BFV() converts decimal fractional value dfv to its binary-encoded representation with nfbits of binary precision. dfv must be passed as a preprocessor literal to preserve leading zeroes. The returned value can be used to set a Q number's fractional bits, for example using Q_SFVAL().