System Grab Bag

View all man pages from Linux (or from all projects)

Name

log2, log2f, log2l - base-2 logarithmic function

Library

Math library ( libm ", " -lm )

Synopsis

#include <math.h> 
double log2(double  x );
float log2f(float x );
long double log2l(long double x );

Feature Test Macro Requirements for glibc (see feature_test_macros(7)):

log2() log2f() log2l()

    _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L

Description

These functions return the base 2 logarithm of x.

Return Value

On success, these functions return the base 2 logarithm of x.

For special cases, including where x is 0, 1, negative, infinity, or NaN, see log(3).

Errors

See math_error(7) for information on how to determine whether an error has occurred when calling these functions.

For a discussion of the errors that can occur for these functions, see log(3).

Attributes

For an explanation of the terms used in this section, see attributes(7). allbox; lbx lb lb T{ log2()log2f()log2l()
InterfaceAttributeValue
T}Thread safetyMT-Safe

Standards

C11, POSIX.1-2008.

History

glibc 2.1. C99, POSIX.1-2001.

The variant returning double also conforms to SVr4, 4.3BSD.

See Also

  1. cbrt(3),
  2. clog2(3),
  3. log(3),
  4. log10(3),
  5. sqrt(3)