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
傳回 的自然對數(基底 e
)。 x
函式會 log10
傳回 base-10 對數。 如果 x
為負數,則這些函式預設會傳回無限期 ( IND
)。 如果 x
為 0,則會傳回無限 ( INF
)。
輸入 | SEH 例外狀況 | _matherr 例外 |
---|---|---|
± QNaN,IND | none | _DOMAIN |
± 0 | ZERODIVIDE |
_SING |
x < 0 |
INVALID |
_DOMAIN |
log
和 log10
具有使用串流 SIMD 延伸模組 2 (SSE2) 的實作。 如需使用 SSE2 實作的資訊和限制,請參閱 _set_SSE2_enable
。
備註
C++ 允許多載,因此您可以呼叫 和 的多載 log
,並 log10
接受 和 傳回 float
或 long double
值。 在 C 程式中,除非您使用 <tgmath.h>
宏來呼叫此函式, log
而且 log10
一律接受 並傳回 double
。
如果您使用 <tgmath.h> log()
宏,引數的類型會決定選取哪一個函式版本。 如需詳細資訊,請參閱 類型泛型數學 。
根據預設,此函式的全域狀態會限定于應用程式。 若要變更此行為,請參閱 CRT 中的全域狀態。
需求
常式 | 必要的標頭 |
---|---|
log , logf , logl , log10 , log10f , log10l |
<math.h> |
log 宏觀 |
<tgmath.h> |
如需相容性詳細資訊,請參閱相容性。
範例
// 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
若要產生其他底數的對數,請使用數學關聯︰a 的對數底數 b == 自然對數 (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
\
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應