CKTIS / C
log1p — C23-Mathematikfunktion
`log1p(x)` aus `<math.h>` berechnet `ln(1 + x)` ohne den Ziffernverlust, der beim getrennten Bilden von `1 + x` für sehr kleines `x` entsteht; `log1pf` und `log1pl` bedienen andere Typen. Der reelle Bereich ist `x >= -1`.
Version: C23
Syntax
double log1p(double x);log1p(x) aus <math.h> berechnet ln(1 + x) ohne den Ziffernverlust, der beim getrennten Bilden von 1 + x für sehr kleines x entsteht; log1pf und log1pl bedienen andere Typen. Der reelle Bereich ist x >= -1.
Das Beispiel prüft, dass log1p(1e-12) ungleich null bleibt, und gibt log1p(1.0) aus. 1 0.693 zeigt den erhaltenen kleinen Zuwachs und ln(2) und nutzt damit den numerischen Vorteil wirklich.
Für x < -1 gilt ein Definitionsbereichsfehler, während bei x == -1 ein Polfehler auftreten kann. Ist ein von null verschiedenes x zu nahe an null, verlangt C23 einen Bereichsfehler. In numerischem Code nicht durch log(1 + x) ersetzen. Annex F bewahrt das Nullvorzeichen, liefert -∞ für -1 mit FE_DIVBYZERO, propagiert NaN und +∞ für positive Unendlichkeit.
Beispiele
#include <math.h>
#include <stdio.h>
int main(void){printf("%d %.3f\n",log1p(1e-12)!=0.0,log1p(1.0));return 0;}
Ergebnis
1 0.693
Das Beispiel prüft, dass `log1p(1e-12)` ungleich null bleibt, und gibt `log1p(1.0)` aus. `1 0.693` zeigt den erhaltenen kleinen Zuwachs und `ln(2)` und nutzt damit den numerischen Vorteil wirklich.