CKTIS / C
log1p — funzione matematica C23
`log1p(x)` di `<math.h>` calcola `ln(1 + x)` senza la perdita di cifre dovuta a formare separatamente `1 + x` per `x` molto piccolo; `log1pf` e `log1pl` servono gli altri tipi. Il dominio reale è `x >= -1`.
Versione: C23
Sintassi
double log1p(double x);log1p(x) di <math.h> calcola ln(1 + x) senza la perdita di cifre dovuta a formare separatamente 1 + x per x molto piccolo; log1pf e log1pl servono gli altri tipi. Il dominio reale è x >= -1.
L’esempio verifica che log1p(1e-12) resti nonzero e stampa log1p(1.0). 1 0.693 mostra la conservazione del piccolo incremento e il valore ln(2), usando davvero il vantaggio numerico.
Per x < -1 c’è domain error e per x == -1 può verificarsi pole error. C23 richiede un range error quando x non nullo è troppo vicino a zero. Non sostituire con log(1 + x) nel codice numerico. Annex F conserva il segno dello zero, restituisce -∞ per -1 con FE_DIVBYZERO, propaga NaN e restituisce +∞ per infinito positivo.
Esempi
#include <math.h>
#include <stdio.h>
int main(void){printf("%d %.3f\n",log1p(1e-12)!=0.0,log1p(1.0));return 0;}
Risultato
1 0.693
L’esempio verifica che `log1p(1e-12)` resti nonzero e stampa `log1p(1.0)`. `1 0.693` mostra la conservazione del piccolo incremento e il valore `ln(2)`, usando davvero il vantaggio numerico.