log10, log10f, log10l
من cppreference.com
معرفة في ملف <math.h> | ||
float log10f(float arg ); | (1) | (منذ C99) |
double log10(double arg ); | (2) | |
longdouble log10l(longdouble arg ); | (3) | (منذ C99) |
معرفة في ملف <tgmath.h> | ||
#define log10( arg ) | (4) | (منذ C99) |
1-3) تحسب اللوغاريتم الشائع (أساس 10) للعدد
arg
.4) ماكرو عام النوع: إذا كان المعطى
arg
من النوع longdouble يتم استدعاء log10l
. أما إذا كان arg
عدد صحيح أو من النوع double يتم استدعاء log10
. فيما عدا ذلك يتم استدعاء log10f
.محتويات |
[تعديل]المعطيات
arg | - | عدد ذو فاصلة عائمة |
[تعديل]القيمة المُرجعة
في حالة النجاح, تُرجعاللوغاريتم الشائع (أساس 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 ONint 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 handlingerrno=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
[تعديل]أنظر أيضا
(C99)(C99) | تحسب اللوغاريتم الطبيعي (الأساس e) (ln(x)) (دالة) |
(C99)(C99)(C99) | تحسب اللوغاريتم للأساس 2 (log2(x)) (دالة) |
(C99)(C99)(C99) | تحسب اللوغاريتم الطبيعي (أساس e) لمجموع العدد المعطى مع الواحد (ln(1+x)) (دالة) |
مقالة مرجع C++ عن log10 |