log2, log2f, log2l

Artiklu
08/03/2021
2 minuti biex taqra

Determines the binary (base-2) logarithm of the specified value.

Syntax

double log2(
   double x
);

float log2(
   float x
); //C++ only

long double log2(
   long double x
); //C++ only

float log2f(
   float x
);

long double log2l(
   long double x
);

#define log2(X) // Requires C11 or higher

Parameters

x
The value to determine the base-2 logarithm of.

Return Value

On success, returns return log2 x.

Otherwise, may return one of the following values:

Issue	Return
x < 0	NaN
x = ±0	-INFINITY
x = 1	+0
+INFINITY	+INFINITY
NaN	NaN
domain error	NaN
pole error	-HUGE_VAL, -HUGE_VALF, or -HUGE_VALL

Errors are reported as specified in _matherr.

Remarks

If x is an integer, this function essentially returns the zero-based index of the most significant 1 bit of x.

By default, this function's global state is scoped to the application. To change this, see Global state in the CRT.

Requirements

Function	C header	C++ header
log2, log2f, log2l	<math.h>	<cmath>
log2 macro	<tgmath.h>

For additional compatibility information, see Compatibility.