log10, log10f, log10l

المعطيات

القيمة المُرجعة

في حالة النجاح, تُرجعاللوغاريتم الشائع (أساس 10) للعدد ‎arg‎ (‏‎ ‏‎log
10(arg)‎ أو lg(arg) ‎ ‎).

لو كان هناك خطأ في المجال يتم إرجاع قيمة تحددها البيئة (غالبا NaN على الأنظمة الداعمة لذلك).

في حالة حدوث خطأ قطبي, يتم إرجاع ‎-HUGE_VAL‎ أو ‎-HUGE_VALF‎ أو ‎-HUGE_VALL‎.

التعامل مع الأخطاء

يتم الإبلاغ عن الأخطاء كما هو موضح في math_errhandling.

في حالة كون ‎arg‎ أصغر من الصفر يحدث خطأ في المجال.

إذا كانت ‎arg‎ بصفر, ربما يحدث خطأ قطبي.

• لو كان المعطى ±0, يتم إرجاع -∞ ويتم رفع الإشارة FE_DIVBYZERO‎.
• لو كان المعطى 1, يتم إرجاع +0
• لو كان المعطى سالبا, يتم إرجاع NaN ويتم رفع الإشارة FE_INVALID‎.
• لو كان المعطى +∞, يتم إرجاع +∞
• لو كان المعطى NaN, يتم إرجاع NaN

مثال

#include <stdio.h>
#include <math.h>
#include <float.h>
#include <errno.h>
#include <fenv.h>
#pragma STDC FENV_ACCESS ON
int main(void)
{
    printf("log10(1000) = %f\n", log10(1000));
    printf("log10(0.001) = %f\n", log10(0.001));
    printf("base-5 logarithm of 125 = %f\n", log10(125)/log10(5));
    // special values
    printf("log10(1) = %f\n", log10(1));
    printf("log10(+Inf) = %f\n", log10(INFINITY));
    //error handling
    errno = 0; feclearexcept(FE_ALL_EXCEPT);
    printf("log10(0) = %f\n", log10(0));
    if(errno == ERANGE) perror("    errno == ERANGE");
    if(fetestexcept(FE_DIVBYZERO)) puts("    FE_DIVBYZERO raised");
}

log10(1000) = 3.000000
log10(0.001) = -3.000000
base-5 logarithm of 125 = 3.000000
log10(1) = 0.000000
log10(+Inf) = inf
log10(0) = -inf
    errno == ERANGE: Numerical result out of range
    FE_DIVBYZERO raised

أنظر أيضا