ContentsIndexPreviousNext

P.1 Introduction

Intrinsic functions are subprograms that are built into the ACUCOBOL-GT library. They save time by simplifying common tasks that your COBOL programs might need to perform. For example, intrinsic functions can perform statistical calculations, convert strings from upper to lower case, compute annuities, derive values for trigonometric functions such as sine and cosine, and perform general utility tasks such as determining the compile date of the current object file.

Intrinsic functions are sometimes called built-in or library functions.

To access an intrinsic function, you include it inside a COBOL statement (typically a MOVE or COMPUTE statement). Here's an example of a statement that uses the "min" intrinsic function:

     move function min(3,8,9,7) to my-minimum.

This COBOL statement can be translated into: move the result derived from performing the "min" function on the literals "3, 8, 9, and 7" to the variable "my-minimum."

Note the presence of the required word "function," followed by the name of the function ("min") and then its parameters.

Each intrinsic function is evaluated to a data value. This value is stored in a temporary storage area that you cannot access directly in your program. The only way to get the derived value of an intrinsic function is to provide the name of a data item into which the resulting value should be placed. In the example shown above, the variable "my-minimum" receives the derived value of the "min" function.

In the example above, the parameters passed to the "min" function are literals. It is also permissible to pass data items, as shown here:

     compute my-sine = function sin(angle-a).