downloads | documentation | faq | getting help | mailing lists | licenses | wiki | reporting bugs | php.net sites | links | conferences | my php.net

search for in the

floor> <exp
Last updated: Fri, 06 Nov 2009

view this page in

expm1

(PHP 4 >= 4.1.0, PHP 5)

expm1 Returns exp(number) - 1, computed in a way that is accurate even when the value of number is close to zero

Description

float expm1 ( float $arg )
Warning

This function is EXPERIMENTAL. The behaviour of this function, its name, and surrounding documentation may change without notice in a future release of PHP. This function should be used at your own risk.

expm1() returns the equivalent to 'exp(arg ) - 1' computed in a way that is accurate even if the value of arg is near zero, a case where 'exp (arg ) - 1' would be inaccurate due to subtraction of two numbers that are nearly equal.

Parameters

arg

The argument to process

Return Values

'e' to the power of arg minus one

Changelog

Version Description
5.3.0 This function is now available on all platforms

See Also

  • log1p() - Returns log(1 + number), computed in a way that is accurate even when the value of number is close to zero
  • exp() - Calculates the exponent of e



add a note add a note User Contributed Notes
expm1
brettz9 AAT yah
03-Apr-2009 04:07
Note that exp(x)-1 can be approximated by x + x^2/2! + ... + x^n/n!  and for any value
hagen at von-eitzen dot de
24-Feb-2003 11:57
Compare this to log1p (which is its inverse).

Also, You may have to use a similar workaraound in case the underlying C library
does not support expm1:

function expm1($x) {
     return ($x>-1.0e-6 && $x<1.0e-6) ? ($x + $x*$x/2) : (exp($x)-1);
}

floor> <exp
Last updated: Fri, 06 Nov 2009
 
 
show source | credits | sitemap | contact | advertising | mirror sites