1 <?xml version=
"1.0" encoding=
"UTF-8"?>
2 <!DOCTYPE book PUBLIC
"-//OASIS//DTD DocBook MathML Module V1.1b1//EN"
3 "http://www.oasis-open.org/docbook/xml/mathml/1.1CR1/dbmathml.dtd">
9 <holder>Khronos Group
</holder>
12 <refentrytitle>frexp
</refentrytitle>
13 <manvolnum>3G
</manvolnum>
16 <refname>frexp
</refname>
17 <refpurpose>split a floating point number
</refpurpose>
19 <refsynopsisdiv><title>Declaration
</title>
22 <funcdef>genType
<function>frexp
</function></funcdef>
23 <paramdef>genType
<parameter>x
</parameter></paramdef>
24 <paramdef>out genIType
<parameter>exp
</parameter></paramdef>
27 <funcdef>genDType
<function>frexp
</function></funcdef>
28 <paramdef>genDType
<parameter>x
</parameter></paramdef>
29 <paramdef>out genIType
<parameter>exp
</parameter></paramdef>
33 <refsect1 id=
"parameters"><title>Parameters
</title>
36 <term><parameter>x
</parameter></term>
39 Specifies the value from which significand and exponent are to be extracted.
44 <term><parameter>out exp
</parameter></term>
47 Specifies the variable into which to place the exponent
53 <refsect1 id=
"description"><title>Description
</title>
55 <function>frexp
</function> extracts
<parameter>x
</parameter> into a floating-point significand
56 in the range [
0.5,
1.0) and in integral exponent of two, such that:
59 <inlineequation><mml:math>
62 <mml:mi>significand
</mml:mi>
63 <mml:mo lspace='
2px' rspace='
2px'
>⋅</mml:mo>
66 <mml:mi>exponent
</mml:mi>
68 </mml:math></inlineequation>
71 The significand is returned by the function and the exponent is returned in the output
72 parameter
<parameter>exp
</parameter>. For a floating-point value of zero, the
73 significand and exponent are both zero. For a floating-point value that is an
74 infinity or a floating-point NaN, the results are undefined.
77 <refsect1 id=
"versions"><title>Version Support
</title>
78 <informaltable frame=
"topbot">
83 <entry>frexp (genType)
</entry>#newin40#
86 <entry>frexp (genDType)
</entry>#newin40#
92 <refsect1 id=
"seealso"><title>See Also
</title>
94 <citerefentry><refentrytitle>ldexp
</refentrytitle></citerefentry>
97 <refsect1 id=
"Copyright"><title>Copyright
</title>
99 Copyright
<trademark class=
"copyright"></trademark> 2011 Khronos Group.
100 This material may be distributed subject to the terms and conditions set forth in
101 the Open Publication License, v
1.0,
8 June
1999.
102 <ulink url=
"http://opencontent.org/openpub/">http://opencontent.org/openpub/
</ulink>.