Namespaces
Variants
Views
Actions

std::logb

From cppreference.com
< cpp‎ | numeric‎ | math
Revision as of 08:31, 11 November 2011 by Cubbi (Talk | contribs)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

Template:cpp/numeric/math/sidebar Template:ddcl list begin <tr class="t-dsc-header">

<td>
Defined in header <cmath>
</td>

<td></td> <td></td> </tr> <tr class="t-dcl ">

<td >
float       logb( float arg );
</td>

<td class="t-dcl-nopad"> </td> <td > Template:mark c++11 feature </td> </tr> <tr class="t-dcl ">

<td >
double      logb( double arg );
</td>

<td class="t-dcl-nopad"> </td> <td > Template:mark c++11 feature </td> </tr> <tr class="t-dcl ">

<td >
long double logb( long double arg );
</td>

<td class="t-dcl-nopad"> </td> <td > Template:mark c++11 feature </td> </tr> Template:ddcl list end

Extracts the value of the exponent from the floating-point argument arg, and returns it as a floating-point value. Formally, the result is the integral part of logr|arg| as a signed floating-point value, for non-zero arg, where r is Template:cpp and T is the floating-point type of arg. If arg is subnormal, it is treated as though it was normalized.

Contents

Parameters

arg - floating point value

Notes

The value of the exponent returned by Template:cpp is always 1 less than the exponent retuned by Template:cpp because of the different normalization requirements: for the exponent e returned by Template:cpp, |arg*r-e| is between 1 and r (typically between Template:cpp and Template:cpp), but for the exponent e returned by Template:cpp, |arg*2-e| is between Template:cpp and Template:cpp.

Return value

The floating-point exponent.

Domain or range error may occur if arg is zero.

Example

Template:example cpp

See also

Template:cpp/numeric/math/dcl list frexpTemplate:cpp/numeric/math/dcl list logbTemplate:cpp/numeric/math/dcl list scalbn