$FUNCNAME$
  LOG()
$CATEGORY$
  NUMERIC
$SUMMARY$
   Calculate the natural logarithm of a numeric value
$LANG_RU$
       .
$SYNTAX$
     LOG(<nExp>) --> nNaturalLog
$LANG_RU$
     LOG(< >) -->  
$ARGUMENTS$
     <nExp> is a numeric value greater than zero to be converted to its
     natural logarithm.
$LANG_RU$
     < > -   .
$RETURNS$
     LOG() returns the natural logarithm as a numeric value.  If <nExp> is
     less than or equal to zero, LOG() returns a numeric overflow (displayed
     as a row of asterisks).
$LANG_RU$
     LOG()       .  
       < >    ,
     LOG()    (*),  
     .
$DESCRIPTION$
     LOG() is a numeric function that calculates the natural logarithm of a
     number and is the inverse of EXP().  The natural logarithm has a base of
     e which is approximately 2.7183.  The LOG() function returns x in the
     following equation,

     e**x = y

     where y is the numeric expression used as the LOG() argument (i.e.,
     LOG(y) = x).  Due to mathematical rounding, the values returned by LOG()
     and EXP() may not agree exactly (i.e., EXP(LOG(x)) may not always equal
     x).
$LANG_RU$
     LOG()   ,   
           EXP().  
       e = 2.7183.  ,  ,
      LOG()  x:

     e ** x = y

      y -  ,     LOG()
     (.. LOG(y) = x). -    
      LOG()  EXP()      (..
     EXP(LOG(x))     x).
$EXAMPLES$
       These examples demonstrate various results of LOG():

	? LOG(10)                  // Result: 2.30
	? LOG(10 * 2)            // Result: 3.00
	? EXP(LOG(1))            // Result: 1.00
	? LOG(2.71)               // Result: 1.00

       This example is a user-defined function that returns the base
	10 logarithm:

	FUNCTION Log10( nNumber )
	IF nNumber > 0
	   RETURN LOG(nNumber)/LOG(10)
	ELSE
	   RETURN NIL
	ENDIF
$LANG_RU$
           LOG() :

       ? LOG(10)              // : 2.30
       ? LOG(10 * 2)          // : 3.00
       ? EXP(LOG(1))          // : 1.00
       ? LOG(2.71)            // : 1.00

           , 
           10:

       FUNCTION Log10( nNumber )
	  IF nNumber > 0
	     RETURN LOG(nNumber) / LOG(10)
	  ELSE
	     RETURN NIL
	  ENDIF
$SEEALSO$
  EXP()
$END$
