Skip to main content

This is documentation for Caché & Ensemble.

For information on converting to InterSystems IRIS, see the InterSystems IRIS Adoption Guide and the InterSystems IRIS In-Place Conversion Guide, both available on the WRC Distributions page (login required).

Previous sectionNext section


Cosecant function.




Argument Description
n An angle in radians.


$ZCSC returns the trigonometric cosecant of n. The result is a signed decimal number.



An angle in radians, specified as a nonzero number. It can be specified as a value, a variable, or an expression. Specifying 0 generates an <ILLEGAL VALUE> error; specifying $DOUBLE(0) generates a <DIVIDE> error. A non-numeric string is evaluated as 0.


The following example permits you to compute the cosecant of a number:

   READ "Input a number: ",num
   IF num=0 { WRITE !,"ILLEGAL VALUE: zero not permitted" }
   ELSE { 
         WRITE !,"the cosecant is: ",$ZCSC(num)
Copy code to clipboard

The following example compares the results from Caché fractional numbers ($DECIMAL numbers) and $DOUBLE numbers. In both cases, the cosecant of pi/2 is exactly 1:

  WRITE !,"the cosecant is: ",$ZCSC($ZPI)
  WRITE !,"the cosecant is: ",$ZCSC($DOUBLE($ZPI))
  WRITE !,"the cosecant is: ",$ZCSC($ZPI/2)
  WRITE !,"the cosecant is: ",$ZCSC($DOUBLE($ZPI)/2)
  WRITE !,"the cosecant is: ",$ZCSC($DOUBLE($ZPI/2))
Copy code to clipboard

See Also