swirl
Guide to OmniMark 7   OmniMark home
docs home 
IndexConceptsTasksSyntaxLibrariesLegacy LibrariesErrors
 
  Related Syntax    
operator  

sqrt

 

 

Return type: OMX
Returns:       

The square root of either a floating point number or BCD number.

For floating point, if x < 0, returns NaN.

For BCD, if x < 0, throws an exception.



Syntax
  define external float function
      sqrt value float x

  define external bcd function
      sqrt value bcd x


Purpose

Use sqrt to calculate the square root of either

You must import either omfloat.xmd or ombcd.xmd in your program. Decide whether you want BCD mathematics (excellent for financial calculations) or floating point mathematics (excellent for extremely large numbers).

Floating Point Example:


  ; Displays the square root of 144 as a floating point number.
  import "omfloat.xmd" unprefixed
  process
    local float x initial {"144"}
    local float result

    set result to sqrt x
    output "result = " || "d" % result || "%n" 

BCD Example:

  ; Displays the square root of 144 as a BCD number.
  import "ombcd.xmd" unprefixed
  process
    local bcd x initial {"144"}
    local bcd result
    local bcd rounded-result

    set result to sqrt x
    set rounded-result to round result bankers-nearest 0.01
    output "The square root of " || "d" % x || " = " || "d" % rounded-result || "%n"
  ; Output: "The square root of 144 = 12"

If you take the square root of an integer, you need to coerce the integer - to a floating point or BCD number - so that the appropriate function is called. The result will depend on which square root function is called.

In an OmniMark program, always surround operators with spaces.

    Related Syntax
   exp
   ln
   log10
   ** (power)
 
 
 

Top [ INDEX ] [ CONCEPTS ] [ TASKS ] [ SYNTAX ] [ LIBRARIES ] [ LEGACYLIBRARIES ] [ ERRORS ]

OmniMark 7.1.2 Documentation Generated: June 28, 2005 at 5:45:47 pm
If you have any comments about this section of the documentation, send email to [email protected]

Copyright © Stilo Corporation, 1988-2005.