log, logf, logl, log10, log10f, log10l

対数を計算します。

構文

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

パラメーター

x
対数を検索する対象の値。

戻り値

正常に終了した場合、log 関数では x の自然対数 (底 e) を返します。 log10 関数では 10 を底とする対数を返します。 x が負の場合、これらの関数では既定で不定値 (IND) を返します。 x が 0 の場合、無限 (INF) を返します。

入力	SEH 例外	_matherr 例外
± QNaN、IND	なし	_DOMAIN
± 0	ZERODIVIDE	_SING
x < 0	INVALID	_DOMAIN

log と log10 には、ストリーミング SIMD 拡張命令 2 (SSE2) を使用する実装があります。 SSE2 実装の使い方の詳細および制約については、「_set_SSE2_enable」を参照してください。

解説

C++ ではオーバーロードが可能であるため、float または long double の値を受け取って返す log と log10 のオーバーロードを呼び出すことができます。 C プログラムでは、<tgmath.h> マクロを使用してこの関数を呼び出す場合を除き、log および log10 では常に double を受け取って返します。

<tgmath.h> log() マクロを使用する場合は、引数の型によって、選択される関数のバージョンが決定されます。 詳細については、「ジェネリック型数値演算」を参照してください。

既定では、この関数のグローバル状態の適用対象は、アプリケーションになります。 この動作を変更するには、「CRT のグローバル状態」を参照してください。

必要条件

ルーチンによって返される値	必須ヘッダー
log, logf, logl, log10, log10f, log10l	<math.h>
log マクロ	<tgmath.h>

互換性の詳細については、「 Compatibility」を参照してください。

例

// 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

他の底の対数を生成するには、数学的関係を使用します。b を底とする a の対数== 自然対数 (a) / 自然対数 (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

関連項目

数学と浮動小数点のサポート
exp, expf, expl
_matherr
pow, powf, powl
_CIlog
_CIlog10\