Built-in Functions › ARC COSINE

ARC COSINE

Purpose

Returns the arc cosine of a numeric value that represents an angle in either degrees or radians.

Syntax

Arc cosine (degrees):

►►─┬─ ARCCOSINE-DEGREES ─┬─ ( value ) ────────────────────────────────────────►◄
   ├─ ARCCOSDEG ─────────┤
   └─ ACOSD ─────────────┘

Arc cosine (radians):

►►─┬─ ARCCOSINE-RADIANS ─┬─ ( value ) ────────────────────────────────────────►◄
   ├─ ARCCOSRAD ─────────┤
   └─ ACOSR ─────────────┘

Parameters

ARCCOSINE-DEGREES

Returns an arc cosine value in degrees.

ARCCOSINE-RADIANS

Returns an arc cosine value in radians.

value

Specifies the numeric value representing the angle, in degrees or radians, whose arc cosine is calculated.

Value can be:

• An arithmetic expression
• The name of a user-defined variable data field
• A user-supplied numeric literal

Value must be a value ranging from -1 to +1.

Example

In the following example, the arc cosine (degrees) of -0.5 is calculated and moved to WK-RESULT (PIC S999V9999):

MOVE ACOSD(-0.5) TO WK-RESULT.
Returned value: 120.