NAME

log2 - calculate the base-2 logarithm of a number

log2, log2f, log2l - base-2 logarithmic function

LIBRARY

Math library (libm, -lm)

SYNOPSIS

Header File

#include <math.h>

Prototype

double log2(double x);
#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

This function calculates the base-2 logarithm of x.

These functions return the base-2 logarithm of x.

RETURN VALUE

This function returns, as a double, the base-2 logarithm of x.

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).

EXAMPLE

#include <math.h>
#include
<stdio.h>
int main(void) { printf("This is CS%i\n", (int) log2(1125899906842624)); }

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).

Interface Attribute Value

log2(), log2f(), log2l()

Thread safety MT-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

cbrt(3), clog2(3), log(3), log10(3), sqrt(3)