log, logf, logl, log10, log10f, log10l

Calcula logaritmos.

Sintaxe

double log(double x);
float logf(float x);
long double logl(double x);
double log10(double x);
float log10f (float x);
long double log10l(double x);
#define log(X) // Requires C11 or higher
#define log10(X) // Requires C11 or higher

float log(float x);  // C++ only
long double log(long double x);  // C++ only
float log10(float x);  // C++ only
long double log10(long double x);  // C++ only

Parâmetros

x
Valor cujo logaritmos deve ser localizado.

Retornar valor

As funções log retornarão o logaritmo natural (base e) de x se tiverem êxito. As funções log10 retornam o logaritmo de base 10. Se x for negativo, essas funções retornarão um indefinido (IND), por padrão. Se x for 0, eles retornarão infinito (INF).

Entrada	Exceção SEH	Exceção _matherr
± QNaN, IND	nenhum	_DOMAIN
± 0	ZERODIVIDE	_SING
x < 0	INVALID	_DOMAIN

log e log10 têm uma implementação que usa SSE2 (Extensões SIMD de Streaming 2). Confira _set_SSE2_enable para obter informações e restrições sobre como usar a implementação de SSE2.

Comentários

O C++ permite sobrecargas, de modo que é possível chamar sobrecargas de log e log10 que recebem e retornam valores float ou long double. Em um programa C, a menos que você esteja usando a macro <tgmath.h> para chamar essa função, log e log10 sempre receberão e retornarão um double.

Se você usar a macro <tgmath.h> log(), o tipo do argumento determinará qual versão da função será selecionada. Confira Matemática do tipo genérico para obter detalhes.

Por padrão, o estado global dessa função tem como escopo o aplicativo. Para alterar esse comportamento, consulte Estado global na CRT.

Requisitos

Rotina	Cabeçalho necessário
log, logf, logl, log10, log10f, log10l	<math.h>
Macro log	<tgmath.h>

Para obter informações sobre compatibilidade, consulte Compatibilidade.

Exemplo

// crt_log.c
/* This program uses log and log10
* to calculate the natural logarithm and
* the base-10 logarithm of 9,000.
*/

#include <math.h>
#include <stdio.h>

int main( void )
{
   double x = 9000.0;
   double y;

   y = log( x );
   printf( "log( %.2f ) = %f\n", x, y );
   y = log10( x );
   printf( "log10( %.2f ) = %f\n", x, y );
}

log( 9000.00 ) = 9.104980
log10( 9000.00 ) = 3.954243

Para gerar logaritmos para outras bases, use a relação matemática: log base b de a == log natural (a) / log natural (b).

// logbase.cpp
#include <math.h>
#include <stdio.h>

double logbase(double a, double base)
{
   return log(a) / log(base);
}

int main()
{
   double x = 65536;
   double result;

   result = logbase(x, 2);
   printf("Log base 2 of %lf is %lf\n", x, result);
}

Log base 2 of 65536.000000 is 16.000000

Confira também

Suporte a matemática e ponto flutuante
exp, expf, expl
_matherr
pow, powf, powl
_CIlog
_CIlog10\