第九十三章 Caché 函数大全 $SIN 函数

返回指定角度值的三角正弦值。

大纲

$ZSIN(n)

参数

n 以弧度表示的角度，范围从π到2π(含)。其他提供的数值被转换为该范围内的值。

描述

$ZSIN返回n的三角正弦值。结果是一个有符号的十进制数，范围从1到-1(见注释)。$ZSIN(0)返回0。$ZSIN($ZPI/2)返回1。

注意:$ZSIN(像所有三角函数一样)基于圆周率计算其值，圆周率四舍五入到可用的小数位数。因此，由$ZSIN($ZPI)返回的值是. 00000000000000000462644，而$ZSIN($ZPI*2)是–0000000000000000092529。因此，不应该执行将这些返回值与0进行比较的极限测试。

参数

n

从π到2π(含2π)的弧度角。它可以被指定为值、变量或表达式。可以使用$ZPI特殊变量来指定圆周率值。可以指定小于π或大于2π的正值或负值；Caché将这些值解析为对应的圆周率倍数。比如3π相当于π，负π相当于π。

非数字字符串的计算结果为0。

示例

以下示例允许计算一个数的正弦值:

DHC-APP>d ##class(PHA.TEST.Function).ZSIN()
Input a number: 2
the sine is: .909297426825681696

以下示例比较了Caché小数($DECIMAL numbers)和$DOUBLE numbers的结果。在这两种情况下，pi的正弦是一个小数(不是0)，但pi/2的正弦恰好设置为1:

/// d ##class(PHA.TEST.Function).ZSIN1()
ClassMethod ZSIN1()
{
	WRITE !,"the sine is: ",$ZSIN($ZPI)
	WRITE !,"the sine is: ",$ZSIN($DOUBLE($ZPI))
	WRITE !,"the sine is: ",$ZSIN($ZPI/2)
	WRITE !,"the sine is: ",$ZSIN($DOUBLE($ZPI)/2)
}

DHC-APP>d ##class(PHA.TEST.Function).ZSIN1()
 
the sine is: .000000000000000000462643
the sine is: .00000000000000012246467991473532071
the sine is: 1
the sine is: 1

在以下示例中，所有$ZSIN函数都返回零(0):

/// d ##class(PHA.TEST.Function).ZSIN2()
ClassMethod ZSIN2()
{
	WRITE !,"the sine is: ",$ZSIN(0.0)
	WRITE !,"the sine is: ",$ZSIN(-0.0)
	WRITE !,"the sine is: ",$ZSIN($DECIMAL(0.0))
	WRITE !,"the sine is: ",$ZSIN($DOUBLE(0.0))
	WRITE !,"the sine is: ",$ZSIN($DECIMAL(-0.0))
	WRITE !,"the sine is: ",$ZSIN($DOUBLE(-0.0))
	WRITE !,"the sine is: ",$ZSIN(-$DECIMAL(0.0))
	WRITE !,"the sine is: ",$ZSIN(-$DOUBLE(0.0))
}

DHC-APP>d ##class(PHA.TEST.Function).ZSIN2()
 
the sine is: 0
the sine is: 0
the sine is: 0
the sine is: 0
the sine is: 0
the sine is: 0
the sine is: 0
the sine is: 0