1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
|
<table class="head">
<tr>
<td class="head-ltitle">Q_IRAWMASK(3)</td>
<td class="head-vol">Library Functions Manual</td>
<td class="head-rtitle">Q_IRAWMASK(3)</td>
</tr>
</table>
<div class="manual-text">
<section class="Sh">
<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
<p class="Pp"><code class="Nm">Q_IRAWMASK</code>,
<code class="Nm">Q_GIRAW</code>, <code class="Nm">Q_GIABSVAL</code>,
<code class="Nm">Q_GIVAL</code>, <code class="Nm">Q_SIVAL</code> —
<span class="Nd">fixed-point math functions which manipulate the integer
data bits</span></p>
</section>
<section class="Sh">
<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
<p class="Pp"><code class="In">#include
<<a class="In">sys/qmath.h</a>></code></p>
<p class="Pp"><var class="Ft">ITYPE</var>
<br/>
<code class="Fn">Q_IRAWMASK</code>(<var class="Fa" style="white-space: nowrap;">QTYPE
q</var>);</p>
<p class="Pp"><var class="Ft">ITYPE</var>
<br/>
<code class="Fn">Q_GIRAW</code>(<var class="Fa" style="white-space: nowrap;">QTYPE
q</var>);</p>
<p class="Pp"><var class="Ft">ITYPE</var>
<br/>
<code class="Fn">Q_GIABSVAL</code>(<var class="Fa" style="white-space: nowrap;">QTYPE
q</var>);</p>
<p class="Pp"><var class="Ft">ITYPE</var>
<br/>
<code class="Fn">Q_GIVAL</code>(<var class="Fa" style="white-space: nowrap;">QTYPE
q</var>);</p>
<p class="Pp"><var class="Ft">QTYPE</var>
<br/>
<code class="Fn">Q_SIVAL</code>(<var class="Fa" style="white-space: nowrap;">QTYPE
q</var>, <var class="Fa" style="white-space: nowrap;">ITYPE iv</var>);</p>
</section>
<section class="Sh">
<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
<p class="Pp"><a class="permalink" href="#Q_IRAWMASK"><code class="Fn" id="Q_IRAWMASK">Q_IRAWMASK</code></a>()
returns a <var class="Fa">q</var>-specific bit mask for
<var class="Fa">q</var>'s integer data bits.</p>
<p class="Pp" id="Q_GIRAW"><a class="permalink" href="#Q_GIRAW"><code class="Fn">Q_GIRAW</code></a>()
returns <var class="Fa">q</var>'s raw masked integer data bits.</p>
<p class="Pp" id="Q_GIABSVAL"><a class="permalink" href="#Q_GIABSVAL"><code class="Fn">Q_GIABSVAL</code></a>()
and
<a class="permalink" href="#Q_GIVAL"><code class="Fn" id="Q_GIVAL">Q_GIVAL</code></a>()
return the absolute and real values of <var class="Fa">q</var>'s integer
data bits respectively.</p>
<p class="Pp" id="Q_SIVAL"><a class="permalink" href="#Q_SIVAL"><code class="Fn">Q_SIVAL</code></a>()
sets <var class="Fa">q</var>'s integer data bits to the value
<var class="Fa">iv</var>.</p>
<p class="Pp">All of those functions operate on the following data types:
<var class="Vt">s8q_t</var>, <var class="Vt">u8q_t</var>,
<var class="Vt">s16q_t</var>, <var class="Vt">u16q_t</var>,
<var class="Vt">s32q_t</var>, <var class="Vt">u32q_t</var>,
<var class="Vt">s64q_t</var>, and <var class="Vt">u64q_t</var>, which are
referred to generically as <var class="Fa">QTYPE</var>. The
<var class="Fa">ITYPE</var> refers to the <a class="Xr">stdint(7)</a>
integer types.</p>
<p class="Pp">For more details, see <a class="Xr">qmath(3)</a>.</p>
</section>
<section class="Sh">
<h1 class="Sh" id="RETURN_VALUES"><a class="permalink" href="#RETURN_VALUES">RETURN
VALUES</a></h1>
<p class="Pp"><code class="Fn">Q_IRAWMASK</code>(),
<code class="Fn">Q_GIRAW</code>(), <code class="Fn">Q_GIABSVAL</code>() and
<code class="Fn">Q_GIVAL</code>() return their respective values as integers
of the same underlying ITYPE as <var class="Fa">q</var>.</p>
<p class="Pp"><code class="Fn">Q_SIVAL</code>() returns the value of
<var class="Fa">q</var> post change.</p>
</section>
<section class="Sh">
<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
ALSO</a></h1>
<p class="Pp"><a class="Xr">errno(2)</a>, <a class="Xr">qmath(3)</a>,
<a class="Xr">stdint(7)</a></p>
</section>
<section class="Sh">
<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
<p class="Pp">The <a class="Xr">qmath(3)</a> functions first appeared in
<span class="Ux">FreeBSD 13.0</span>.</p>
</section>
<section class="Sh">
<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
<p class="Pp">The <a class="Xr">qmath(3)</a> functions and this manual page were
written by <span class="An">Lawrence Stewart</span>
<<a class="Mt" href="mailto:lstewart@FreeBSD.org">lstewart@FreeBSD.org</a>>
and sponsored by Netflix, Inc.</p>
</section>
</div>
<table class="foot">
<tr>
<td class="foot-date">July 8, 2018</td>
<td class="foot-os">FreeBSD 15.0</td>
</tr>
</table>
|
