Files
harbour-core/harbour/doc/en/math.txt
Viktor Szakats 45a114e471 2010-06-03 18:17 UTC+0200 Viktor Szakats (harbour.01 syenar.hu)
* tests/testsha1.prg
  * tests/longdev.prg
  * tests/clsccast.prg
  * tests/cmphello.prg
  * tests/clsicast.prg
  * tests/testop.prg
  * tests/clsscast.prg
  * tests/objarr.prg
  * tests/rddtest/rddmktst.prg
  * tests/rddtest/adscl52.prg
  * tests/rddtest/adscl53.prg
  * tests/rddtest/ntxcl52.prg
  * tests/rddtest/ntxcl53.prg
  * tests/rddtest/cdxcl52.prg
  * tests/rddtest/rddtst.prg
  * tests/rddtest/cdxcl53.prg
  * tests/transtst.prg
  * tests/output.prg
  * tests/ac_test2.prg
  * tests/clsscope.prg
  * tests/dosshell.prg
  * tests/sbartest.prg
  * tests/speedold.prg
  * tests/sdf_test.prg
  * tests/wcecon.prg
  * tests/debugtst.prg
  * tests/testdyn.c
  * tests/multiarg.prg
  * tests/fornext.prg
  * tests/hbinline.prg
  * tests/foreach2.prg
  * tests/objasign.prg
  * tests/scroll.prg
  * tests/inherit.prg
  * tests/rto_get.prg
  * tests/boxtst2.prg
  * tests/inkeytst.prg
  * tests/overload.prg
  * tests/cpinfo.prg
  * tests/gtwin.prg
  * tests/mt/mttest08.prg
  * tests/mt/mttest09.prg
  * tests/mt/mttest01.prg
  * tests/mt/mttest10.prg
  * tests/mt/mttest02.prg
  * tests/mt/mttest11.prg
  * tests/mt/mttest03.prg
  * tests/mt/mttest12.prg
  * tests/mt/mttest04.prg
  * tests/mt/mttest05.prg
  * tests/mt/mttest06.prg
  * tests/mt/mttest07.prg
  * tests/speedtst.prg
  * tests/testsha2.prg
  * tests/hsxtest.prg
  * tests/arrayidx.prg
  * tests/clsnv.prg
  * tests/rto_tb.prg
  * tests/gtchars.prg
  * tests/disptest.prg
  * tests/funcarr.prg
  * tests/testhtml.prg
  * tests/readhrb.prg
  * tests/tstcolor.prg
  * tests/gtxfnt.prg
  * tests/devtest.prg
  * tests/aliaslck.prg
  * tests/stripem.prg
  * tests/dynobj.prg
  * tests/tb1.prg
  * tests/round.prg
  * tests/longstr.prg
  * tests/testdyn.prg
  * tests/testdyn1.prg
  * tests/delimtst.prg
  * tests/tstdspac.prg
  * tests/version.prg
  * tests/setkeys.prg
  * tests/gtcolors.prg
  * tests/destruct.prg
  * tests/seconds.prg
  * tests/gtkeys.prg
  * tests/usrrdd/exarr.prg
  * doc/en/diskspac.txt
  * doc/en/string.txt
  * doc/en/rdd.txt
  * doc/en/hashes.txt
  * doc/en/hb_apigt.txt
  * doc/en/rddord.txt
  * doc/en/hb_api.txt
  * doc/en/hb_date.txt
  * doc/en/math.txt
  * doc/en/hb_vm.txt
  * doc/en/treport.txt
  * doc/en/terminal.txt
  * doc/en/hb_apiln.txt
  * doc/en/dir.txt
  * doc/en/command.txt
  * doc/en/rddmisc.txt
  * doc/en/errsys.txt
  * doc/en/nation.txt
  * doc/en/var.txt
  * doc/en/dbstrux.txt
  * doc/en/datetime.txt
  * doc/en/memo.txt
  * doc/en/tgetlist.txt
  * doc/en/tlabel.txt
  * doc/en/1stread.txt
  * doc/en/hb_set.txt
  * doc/en/hb_compa.txt
  * doc/en/hb_apier.txt
  * doc/en/hbinet.txt
  * doc/en/hb_macro.txt
  * doc/en/array.txt
  * doc/en/hb_apiit.txt
  * doc/en/rdddb.txt
  * doc/en/dbsdf.txt
  * doc/en/hvm.txt
  * doc/en/input.txt
  * doc/en/dbdelim.txt
  * doc/en/browse.txt
  * doc/en/menu.txt
  * doc/en/hb_apird.txt
  * doc/en/hb_apifs.txt
  * doc/en/file.txt
  * doc/en/lang.txt
  * doc/en/objfunc.txt
  * doc/en/eval.txt
  * doc/en/binnum.txt
  * doc/en/tclass.txt
  * doc/en/misc.txt
  * doc/en/set.txt
  * doc/en/readme.txt
  * doc/man/harbour.1
  * doc/man/hbmk2.1
  * doc/man/hbpp.1
  * doc/man/hbtest.1
  * doc/man/hbrun.1
  * examples/hbextern/hbextern.prg
  * examples/pp/pp.c
  * examples/pp/hbpragma.c
  * examples/pp/hbppcore.c
  * examples/pp/hbppcomp.c
  * examples/pp/hbpptbl.c
  * examples/pp/hbppdef.h
  * examples/superlib/hbsuper.prg
  * examples/hbsqlit2/hbsqlit2.ch
  * examples/misc/mankala.prg
  * examples/misc/guess.prg
  * examples/rddado/adordd.prg
  * examples/rddado/adordd.ch
  * examples/hbapollo/apollo.ch
  * examples/hbapollo/apollo.c
  * examples/hbapollo/apollo1.prg
  * examples/hbdoc2/gentpl.prg
  * examples/hbdoc2/gentxt.prg
  * examples/hbdoc2/tmplates.prg
  * examples/hbdoc2/genxml.prg
  * examples/hbdoc2/genhtml.prg
  * examples/hbdoc2/hbdoc2.prg
  * examples/hbdoc2/hbdoc2.ch
  * examples/guestbk/guestbk.prg
  * examples/httpsrv/uhttpd.ini
  * examples/httpsrv/uhttpd.prg
  * examples/httpsrv/cookie.prg
  * examples/httpsrv/cgifunc.prg
  * examples/httpsrv/session.prg
  * examples/terminal/trm_cli.prg
  * examples/terminal/terminal.prg
  * examples/terminal/trm_srv.prg
  * examples/terminal/trm_app.prg
  * examples/hbbtree/hb_btree.h
  * examples/hbbtree/hb_btree.ch
  * examples/hbbtree/hb_btree.c
  * examples/hbbtree/tbtree.prg
  * examples/hscript/hscript.prg
  * examples/hscript/dir.hs
  * examples/hscript/multiply.hs
  * examples/hscript/ugly.hs
  * examples/hscript/hello.hs
  * examples/gtwvw/hbole.h
  * examples/gtwvw/wvwdraw.c
  * examples/gtwvw/wvwmenu.c
  * examples/gtwvw/gtwvw.c
  * examples/gtwvw/wvwstbar.c
  * examples/gtwvw/wvwcheck.c
  * examples/gtwvw/wvwfuncs.c
  * examples/gtwvw/wvwpush.c
  * examples/gtwvw/wvwedit.c
  * examples/gtwvw/wvwtbar.c
  * examples/gtwvw/hbgtwvw.h
    * Deleted 'www.' from harbour-project.org website name.
      (www.harbour-project.org -> harbour-project.org)
2010-06-03 16:23:36 +00:00

745 lines
16 KiB
Plaintext

/*
* $Id$
*/
/*
* The following parts are Copyright of the individual authors.
* www - http://harbour-project.org
*
* Copyright 2000 Luiz Rafael Culik <culik@sl.conex.net>
* Documentation for: ABS(),EXP(),LOG(),INT(),MAX()
* MIN(),SQRT(),ROUND()
* Copyright 2001 IntTec GmbH, Neunlindenstr 32, 79106 Freiburg, Germany
* Author: Martin Vogel <vogel@inttec.de>
* Documentation for API
* $SUBCATEGORY$
* Math functions
* See COPYING for licensing terms.
*
*/
/* $DOC$
* $TEMPLATE$
* Function
* $NAME$
* ABS()
* $CATEGORY$
* API
* $SUBCATEGORY$
* Math
* $ONELINER$
* Return the absolute value of a number.
* $SYNTAX$
* ABS(<nNumber>) --> <nAbsNumber>
* $ARGUMENTS$
* <nNumber> Any number.
* $RETURNS$
* <nAbsNumber> The absolute numeric value.
* $DESCRIPTION$
* This function yields the absolute value of the numeric value or
* expression <nNumber>.
* $EXAMPLES$
* Proc Main()
*
* Local nNumber:=50
* Local nNumber1:=27
* cls
*
* qout(nNumber-nNumber1)
* qout(nNumber1-nNumber)
* qout(ABS(nNumber-nNumber1))
* qout(ABSnNumber1-nNumber))
* qout(ABS( -1 * 345))
* $STATUS$
* R
* $COMPLIANCE$
* C
* $PLATFORMS$
* All
* $FILES$
* Library is rtl
* $SEEALSO$
*
* $END$
*/
/* $DOC$
* $TEMPLATE$
* Function
* $NAME$
* EXP()
* $CATEGORY$
* API
* $SUBCATEGORY$
* Math
* $ONELINER$
* Calculates the value of e raised to the passed power.
* $SYNTAX$
* EXP( <nNumber> ) --> <nValue>
* $ARGUMENTS$
* <nNumber> Any real number.
* $RETURNS$
* <nValue> The anti-logarithm of <nNumber>
* $DESCRIPTION$
* This function returns the value of e raised to the power of
* <nNumber>. It is the inverse of LOG().
* $EXAMPLES$
* ? EXP(45)
* $STATUS$
* R
* $COMPLIANCE$
* C
* $PLATFORMS$
* All
* $FILES$
* Library is rtl
* $SEEALSO$
* LOG()
* $END$
*/
/* $DOC$
* $TEMPLATE$
* Function
* $NAME$
* INT()
* $CATEGORY$
* API
* $SUBCATEGORY$
* Math
* $ONELINER$
* Return the integer port of a numeric value.
* $SYNTAX$
* INT( <nNumber> ) --> <nIntNumber>
* $ARGUMENTS$
* <nNumber> Any numeric value.
* $RETURNS$
* <nIntNumber> The integer portion of the numeric value.
* $DESCRIPTION$
* This function converts a numeric expression to an integer. All
* decimal digits are truncated. This function does not round a value
* upward or downward; it merely truncates a number at the decimal
* point.
* $EXAMPLES$
* SET Decimal to 5
* ? INT(632512.62541)
* ? INT(845414111.91440)
* $STATUS$
* R
* $COMPLIANCE$
* C
* $PLATFORMS$
* All
* $FILES$
* Library is rtl
* $SEEALSO$
* ROUND(),STRZERO()
* $END$
*/
/* $DOC$
* $TEMPLATE$
* Function
* $NAME$
* LOG()
* $CATEGORY$
* API
* $SUBCATEGORY$
* Math
* $ONELINER$
* Returns the natural logarithm of a number.
* $SYNTAX$
* LOG( <nNumber> ) --> <nLog>
* $ARGUMENTS$
* <nNumber> Any numeric expression.
* $RETURNS$
* <nExponent> The natural logarithm of <nNumber>.
* $DESCRIPTION$
* This function returns the natural logarithm of the number <nNumber>.
* If <nNumber> is 0 or less than 0, a numeric overflow occurs,
* which is depicted on the display device as a series of asterisks.
* This function is the inverse of EXP().
* $EXAMPLES$
* ? LOG(632512)
* $STATUS$
* R
* $COMPLIANCE$
* C
* $PLATFORMS$
* All
* $FILES$
* Library is rtl
* $SEEALSO$
* EXP()
* $END$
*/
/* $DOC$
* $TEMPLATE$
* Function
* $NAME$
* MAX()
* $CATEGORY$
* API
* $SUBCATEGORY$
* Math
* $ONELINER$
* Returns the maximum of two numbers or dates.
* $SYNTAX$
* MAX(<xValue>,<xValue1>) --> <xMax>
* $ARGUMENTS$
* <xValue> Any date or numeric value.
*
* <xValue1> Any date or numeric value (same type as <xValue>).
* $RETURNS$
* <xMax> The larger numeric (or later date) value.
* $DESCRIPTION$
* This function returns the larger of the two passed espressions. If
* <xValue> and <xValue1> are numeric data types, the value returned by
* this function will be a numeric data type as well and will be the
* larger of the two numbers passed to it. If <xValue> and <xValue1>
* are date data types, the return value will be a date data type as
* well. It will be the later of the two dates passed to it.
* $EXAMPLES$
* ? MAX(214514214,6251242142)
* ? MAX(CTOD('11/11/2000'),CTOD('21/06/2014')
* $STATUS$
* R
* $COMPLIANCE$
* C
* $PLATFORMS$
* All
* $FILES$
* Library is rtl
* $SEEALSO$
* Min()
* $END$
*/
/* $DOC$
* $TEMPLATE$
* Function
* $NAME$
* MIN()
* $CATEGORY$
* API
* $SUBCATEGORY$
* Math
* $ONELINER$
* Determines the minumum of two numbers or dates.
* $SYNTAX$
* MIN(<xValue>,<xValue1>) --> <xMin>
* $ARGUMENTS$
* <xValue> Any date or numeric value.
*
* <xValue1> Any date or numeric value.
* $RETURNS$
* <xMin> The smaller numeric (or earlier date) value.
* $DESCRIPTION$
* This function returns the smaller of the two passed espressions.
* <xValue> and <xValue1> must be the same data type. If numeric, the
* smaller number is returned. If dates, the earlier date is returned.
* $EXAMPLES$
* ? MIN(214514214,6251242142)
* ? MIN(CTOD('11/11/2000'),CTOD('21/06/2014')
* $STATUS$
* R
* $COMPLIANCE$
* C
* $PLATFORMS$
* All
* $FILES$
* Library is rtl
* $SEEALSO$
* MAX()
* $END$
*/
/* $DOC$
* $TEMPLATE$
* Function
* $NAME$
* MOD()
* $CATEGORY$
* API
* $SUBCATEGORY$
* Math
* $ONELINER$
* Return the modulus of two numbers.
* $SYNTAX$
* MOD( <nNumber>,<nNumber1>) --> <nRemainder>
* $ARGUMENTS$
* <nNumber> Numerator in a divisional expression.
*
* <nNumber1> Denominator in a divisional expression.
* $RETURNS$
* <nRemainder> The remainder after the division operation.
* $DESCRIPTION$
* This functuion returns the remainder of one number divided by
* another.
* $EXAMPLES$
* ? MOD(12,8.521)
* ? Mod(12,0)
* ? Mod(62412.5142,4522114.12014)
* $STATUS$
* R
* $COMPLIANCE$
* C
* $PLATFORMS$
* All
* $FILES$
* Library is rtl
* $SEEALSO$
* %
* $END$
*/
/* $DOC$
* $TEMPLATE$
* Function
* $NAME$
* SQRT()
* $CATEGORY$
* API
* $SUBCATEGORY$
* Math
* $ONELINER$
* Calculates the square root of a number.
* $SYNTAX$
* SQRT( <nNumber> ) --> <nSqrt>
* $ARGUMENTS$
* <nNumber> Any numeric value.
* $RETURNS$
* <nSqrt> The square root of <number>.
* $DESCRIPTION$
* This function returns the square root of <nNumber>. The precision
* of this evaluation is based solely on the settings of the
* SET DECIMAL TO command. Any negative number passed as <nNumber>
* will always return a 0.
* $EXAMPLES$
* SET Decimal to 5
* ? SQRT(632512.62541)
* ? SQRT(845414111.91440)
* $STATUS$
* R
* $COMPLIANCE$
* C
* $PLATFORMS$
* All
* $FILES$
* Library is rtl
* $SEEALSO$
* ROUND()
* $END$
*/
/* $DOC$
* $TEMPLATE$
* Function
* $NAME$
* ROUND()
* $CATEGORY$
* API
* $SUBCATEGORY$
* Math
* $ONELINER$
* Rounds off a numeric expression.
* $SYNTAX$
* ROUND( <nNumber>,<nPlace> ) --> <nResult>
* $ARGUMENTS$
* <nNumber> Any numeric value.
*
* <nPlace> The number of places to round to.
* $RETURNS$
* <nResult> The rounded number.
* $DESCRIPTION$
* This function rounds off the value of <nNumber> to the number of
* decimal places specified by <nPlace>. If the value of <nPlace> is
* a negative number, the function will attempt to round <nNumber> in
* whole numbers. Numbers from 5 through 9 will be rounded up, all
* others will be rounded down.
* $EXAMPLES$
* ? ROUND(632512.62541,5)
* ? ROUND(845414111.91440,3)
* $STATUS$
* R
* $COMPLIANCE$
* C
* $PLATFORMS$
* All
* $FILES$
* Library is rtl
* $SEEALSO$
* INT(),STR(),VAL(),SET FIXED
* $END$
*/
/* $DOC$
* $TEMPLATE$
* Function
* $NAME$
* hb_mathGetLastError()
* $CATEGORY$
* C level API
* $SUBCATEGORY$
* Math
* $ONELINER$
* get the last math lib error
* $SYNTAX$
* C Prototype
*
* #include <hbmath.h>
* hb_mathGetLastError (HB_MATH_EXCEPTION * phb_exc)
* --> int iMathErrorType
* $ARGUMENTS$
* phb_exc pointer to HB_MATH_EXCEPTION structure, if not NULL,
* the structure will be filled with information about the
* last math error:
*
* typedef struct _HB_MATH_EXCEPTION {
* int type; // Math error type, is one of the constants
* // HB_MATH_ERR_xxx defined in hbmath.ch
* char *funcname; // Pointer to name of the math C RTL routine
* // that caused the error.
* char *error; // Pointer to error description.
* double arg1; // First and
* double arg2; // Second double argument to the math routine.
* double retval; // Corrected return value for the math routine.
* int retvalwidth; // Width and
* int retvaldec; // Decimals of the corrected return value,
* // both default to -1
* int handled; // 1, if the math error is already corrected,
* // 0 otherwise.
* } HB_MATH_EXCEPTION;
* $RETURNS$
* <iMathErrorType>
* $DESCRIPTION$
*
* $EXAMPLES$
*
* $STATUS$
* R
* $COMPLIANCE$
* NA
* $FILES$
* Header file is hbmath.h
* Library is rtl
* $PLATFORMS$
* All
* $SEEALSO$
*
* $END$
*/
/* $DOC$
* $TEMPLATE$
* Procedure
* $NAME$
* hb_mathResetError()
* $CATEGORY$
* C level API
* $SUBCATEGORY$
* Math
* $ONELINER$
* Reset the internal math error information structure
* $SYNTAX$
* C Prototype
*
* #include <hbmath.h>
* hb_mathResetError (void)
* $ARGUMENTS$
*
* $DESCRIPTION$
*
* $EXAMPLES$
*
* $STATUS$
* R
* $COMPLIANCE$
* NA
* $FILES$
* Header file is hbmath.h
* Library is rtl
* $PLATFORMS$
* All
* $SEEALSO$
*
* $END$
*/
/* $DOC$
* $TEMPLATE$
* Function
* $NAME$
* hb_mathIsMathErr()
* $CATEGORY$
* C level API
* $SUBCATEGORY$
* Math
* $ONELINER$
* Check if harbour math error handling is available
* $SYNTAX$
* C Prototype
*
* #include <hbmath.h>
* hb_mathIsMathErr (void) --> int iIsMathHandler
* $ARGUMENTS$
*
* $RETURNS$
* <iIsMathHandler>
* $DESCRIPTION$
*
* $EXAMPLES$
*
* $STATUS$
* R
* $COMPLIANCE$
* NA
* $FILES$
* Header file is hbmath.h
* Library is rtl
* $PLATFORMS$
* All
* $SEEALSO$
*
* $END$
*/
/* $DOC$
* $TEMPLATE$
* Function
* $NAME$
* hb_mathSetHandler()
* $CATEGORY$
* C level API
* $SUBCATEGORY$
* Math
* $ONELINER$
* set the harbour math handler
* $SYNTAX$
* C Prototype
*
* #include <hbmath.h>
* hb_mathSetHandler (HB_MATH_HANDLERPROC handlerproc)
* --> HB_MATH_HANDLERPROC previous_handerproc
* $ARGUMENTS$
* handlerproc custom math handler
* typedef int (* HB_MATH_HANDLERPROC)(HB_MATH_EXCEPTION * err)
* $RETURNS$
* previous_handlerproc previous math handler
* typedef int (* HB_MATH_HANDLERPROC)(HB_MATH_EXCEPTION * err)
* $DESCRIPTION$
*
* $EXAMPLES$
*
* $STATUS$
* R
* $COMPLIANCE$
* NA
* $FILES$
* Header file is hbmath.h
* Library is rtl
* $PLATFORMS$
* All
* $SEEALSO$
*
* $END$
*/
/* $DOC$
* $TEMPLATE$
* Function
* $NAME$
* hb_mathGetHandler()
* $CATEGORY$
* C level API
* $SUBCATEGORY$
* Math
* $ONELINER$
* get current Harbour math error handler
* $SYNTAX$
* C Prototype
*
* #include <hbmath.h>
* hb_mathGetHandler (void) --> HB_MATH_HANDLERPROC handlerproc
* $ARGUMENTS$
* handlerproc custom math handler
* typedef int (* HB_MATH_HANDLERPROC)(HB_MATH_EXCEPTION * err)
* $RETURNS$
* <handerproc>
* $DESCRIPTION$
*
* $EXAMPLES$
*
* $STATUS$
* R
* $COMPLIANCE$
* NA
* $FILES$
* Header file is hbmath.h
* Library is rtl
* $PLATFORMS$
* All
* $SEEALSO$
*
* $END$
*/
/* $DOC$
* $TEMPLATE$
* Function
* $NAME$
* hb_mathSetErrMode()
* $CATEGORY$
* C level API
* $SUBCATEGORY$
* Math
* $ONELINER$
* set math error handling mode
* $SYNTAX$
* C Prototype
*
* #include <hbmath.h>
* hb_mathSetErrMode (int imode) --> int ioldmode
* $ARGUMENTS$
* imode math error handling mode, one of the following
* constants, defined in hbmath.ch:
* HB_MATH_ERRMODE_DEFAULT
* HB_MATH_ERRMODE_CDEFAULT
* HB_MATH_ERRMODE_USER
* HB_MATH_ERRMODE_USERDEFAULT
* HB_MATH_ERRMODE_USERCDEFAULT
* $RETURNS$
* ioldmode old math error handling mode
* $DESCRIPTION$
*
* $EXAMPLES$
*
* $STATUS$
* R
* $COMPLIANCE$
* NA
* $FILES$
* Header file is hbmath.h
* Library is rtl
* $PLATFORMS$
* All
* $SEEALSO$
* hb_mathGetErrMode()
* $END$
*/
/* $DOC$
* $TEMPLATE$
* Function
* $NAME$
* hb_mathGetErrMode()
* $CATEGORY$
* C level API
* $SUBCATEGORY$
* Math
* $ONELINER$
* get math error handling mode
* $SYNTAX$
* C Prototype
*
* #include <hbmath.h>
* hb_mathGetErrMode (void) --> imode
* $ARGUMENTS$
*
* $RETURNS$
* imode math error handling mode
* $DESCRIPTION$
*
* $EXAMPLES$
*
* $STATUS$
* R
* $COMPLIANCE$
* NA
* $FILES$
* Header file is hbmath.h
* Library is rtl
* $PLATFORMS$
* All
* $SEEALSO$
* hb_mathSetErrMode()
* $END$
*/
/* $DOC$
* $TEMPLATE$
* Function
* $NAME$
* HB_MATHERMODE()
* $CATEGORY$
* API
* $SUBCATEGORY$
* Math
* $ONELINER$
* Set/Get math error handling mode
* $SYNTAX$
* HB_MATHERMODE ([<nNewMode>]) --> <nOldMode>
* $ARGUMENTS$
* [<nNumber>] new math error handling mode, one of the following
* constants, defined in hbmath.ch:
* HB_MATH_ERRMODE_DEFAULT
* HB_MATH_ERRMODE_CDEFAULT
* HB_MATH_ERRMODE_USER
* HB_MATH_ERRMODE_USERDEFAULT
* HB_MATH_ERRMODE_USERCDEFAULT
* $RETURNS$
* <nOldMode> old math error handling mode
* $DESCRIPTION$
*
* $EXAMPLES$
*
* $STATUS$
* R
* $COMPLIANCE$
*
* $PLATFORMS$
* All
* $FILES$
* Header file is hbmath.ch
* Library is rtl
* $SEEALSO$
*
* $END$
*/
/* $DOC$
* $TEMPLATE$
* Function
* $NAME$
* HB_MATHERBLOCK()
* $CATEGORY$
* API
* $SUBCATEGORY$
* Math
* $ONELINER$
* Set/Get math error handling codeblock
* $SYNTAX$
* HB_MATHERBLOCK ([<bNewBlock>]) --> <bOldBlock>
* $ARGUMENTS$
* <bNewBlock>
* $RETURNS$
* <bOldBlock> is the current error handler codeblock
* $DESCRIPTION$
*
* $EXAMPLES$
*
* $STATUS$
* R
* $COMPLIANCE$
*
* $PLATFORMS$
* All
* $FILES$
* Library is rtl
* $SEEALSO$
*
* $END$
*/