WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen