$ZPOWER (ObjectScript)
構文
$ZPOWER(num,exponent)
引数
引数 | 説明 |
---|---|
num | 累乗される数字 |
exponent | 指数 |
概要
$ZPOWER は、num 引数の値の n 乗を返します。
この関数は、指数演算子 (**) と同様の処理を実行します 有効なオペランドと特定の値の組み合わせに対して返される値の詳細は、"指数演算子 (**)" リファレンス・ページを参照してください。
引数
num
累乗される数字。これには、整数、浮動小数点、負の数、正の数、またはゼロを指定します。InterSystems IRIS 標準の数値または IEEE 倍精度バイナリ浮動小数点数 ($DOUBLE 値) で指定できます。値、変数、式として指定することができます。
"数値としての文字列" で説明されているように、num を引用符付きの文字列として指定した場合、文字列は数値として解析されます。NULL 文字列 ("")、および数値以外の文字列は、ゼロに評価されます。
exponent
exponent には、整数、浮動小数点、負の数、正の数、またはゼロを指定します。InterSystems IRIS 標準の数値または IEEE 倍精度バイナリ浮動小数点数 ($DOUBLE 値) で指定できます。数値、文字列値、変数、式として指定することができます。
"数値としての文字列" で説明されているように、exponent を引用符付きの文字列として指定した場合、文字列は数値として解析されます。NULL 文字列 ("")、および数値以外の文字列は、ゼロに評価されます。
次のように num と exponent を組み合わせるとエラーになります。
-
num が負の数の場合、exponent は整数である必要があります。整数でない場合は、<ILLEGAL VALUE> エラーが生成されます。
-
num が 0 の場合、exponent には正の数または 0 を指定する必要があります。 それ以外の数を指定すると、<ILLEGAL VALUE> エラーまたは <DIVIDE> エラーが生成されます。
-
$ZPOWER(9,153) のような大きな値を exponent に指定すると、オーバーフローが発生して <MAXNUMBER> エラーが生成されるか、アンダーフローが発生して 0 が返されることがあります。どちらの結果になるかは、num が 1 (または -1) よりも大きいか、および exponent が正か負かによって決まります。処理で InterSystems IRIS がサポートする最大数を超えた場合、<MAXNUMBER> エラーが発生します。詳細は、"極端に大きな数字" を参照してください。
有効なオペランドと特定の値の組み合わせに対して返される値の詳細は、"指数演算子 (**)" リファレンス・ページを参照してください。
例
以下の例は、2 を 10 乗します。
SET x=0
WHILE x < 10 {
SET rtn=$ZPOWER(2,x)
WRITE !,"The ",x," power of 2=",rtn
SET x=x+1 }