tail head cat sleep
QR code linking to this page

Manual Pages  — Q_IFRAWMASK

NAME

Q_IFRAWMASK, Q_IFVALIMASK, Q_IFVALFMASK, Q_GIFRAW, Q_GIFABSVAL, Q_GIFVAL, Q_SIFVAL, Q_SIFVALS – fixed-point math functions which manipulate the combined integer/fractional data bits

CONTENTS

SYNOPSIS

#include <sys/qmath.h>

ITYPE
Q_IFRAWMASK(QTYPE q);

ITYPE
Q_IFVALIMASK(QTYPE q);

ITYPE
Q_IFVALFMASK(QTYPE q);

ITYPE
Q_GIFRAW(QTYPE q);

ITYPE
Q_GIFABSVAL(QTYPE q);

ITYPE
Q_GIFVAL(QTYPE q);

QTYPE
Q_SIFVAL(QTYPE q, ITYPE ifv);

QTYPE
Q_SIFVALS(QTYPE q, ITYPE iv, ITYPE fv);

DESCRIPTION

Q_IFRAWMASK() returns a q, Ns, -specific bit mask for q, Ap, s combined integer and fractional data bits.

Q_IFVALIMASK() and Q_IFVALFMASK() return q, Ns, -specific bit masks for the integer and fractional bits of q, Ap, s combined integer and fractional data bits value, i.e., are applicable to the values returned by Q_GIFABSVAL() and Q_GIFVAL().

Q_GIFRAW() returns q, Ap, s raw masked integer/fractional data bits.

Q_GIFABSVAL() and Q_GIFVAL() return the absolute and real values of q, Ap, s integer/fractional data bits respectively.

Q_SIFVAL() sets q, Ap, s combined integer/fractional data bits to the value ifv, whereas Q_SIFVALS() independently sets q, Ap, s integer and fractional data bits to the separate values iv and fv.

All of those functions operate on the following data types: s8q_t, u8q_t, s16q_t, u16q_t, s32q_t, u32q_t, s64q_t, and u64q_t, which are referred to generically as QTYPE. The ITYPE refers to the stdint(7) integer types.

For more details, see qmath(3).

RETURN VALUES

Q_IFRAWMASK(), Q_IFVALIMASK(), Q_IFVALFMASK(), Q_GIFABSVAL(), Q_GIFVAL(), Q_GIFRAW(), Q_GIFABSVAL() and Q_GIFVAL() return their respective values as integers of the same underlying ITYPE as q.

Q_SIFVAL() and Q_SIFVALS() return the value of q post change.

SEE ALSO

errno(2), qmath(3), stdint(7)

HISTORY

The qmath(3) functions first appeared in FreeBSD 13.0 .

AUTHORS

The qmath(3) functions and this manual page were written by Lawrence Stewart <Mt lstewart@FreeBSD.org> and sponsored by Netflix, Inc.

Q_IFRAWMASK (3) July 8, 2018

tail head cat sleep
QR code linking to this page


Please direct any comments about this manual page service to Ben Bullock. Privacy policy.

What is this horrible fascination with Unix? The operating system of the 1960s, still gaining in popularity in the 1990s.
— Donald A. Norman