This is documentation for Caché & Ensemble. See the InterSystems IRIS version of this content.

For information on migrating to InterSystems IRIS, see the InterSystems IRIS Migration Guide and Migrating to InterSystems IRIS, both available on the WRC Distributions page (login required).

# Cos

Returns the cosine of an angle.

## Synopsis

```Cos(number)
```

### Arguments

The number argument can be any valid numeric expression that expresses an angle in radians.

## Description

The Cos function takes an angle and returns the ratio of two sides of a right triangle. The ratio is the length of the side adjacent to the angle divided by the length of the hypotenuse. The result lies in the range -1 to 1.

To convert degrees to radians, multiply degrees by pi/180. To convert radians to degrees, multiply radians by 180/pi.

## Examples

The following example uses the Cos function to return the cosine of an angle:

```Dim MyAngle
MyAngle = 1.3           ' Define angle in radians.
Println Cos(MyAngle)    ' Calculate cosine.```

The following example uses the Cos function to return the secant of an angle:

```Dim MyAngle, MySecant
MyAngle = 1.3                ' Define angle in radians.
MySecant = 1 / Cos(MyAngle)  ' Calculate secant.
Println MySecant```