Skip to main content

This is documentation for Caché & Ensemble. See the InterSystems IRIS version of this content.Opens in a new tab

For information on migrating to InterSystems IRISOpens in a new tab, see Why Migrate to InterSystems IRIS?

$ZPOWER

数値の指定した累乗の値を返します。

Synopsis

$ZPOWER(num,exponent)

パラメータ

num 累乗される数字
exponent 指数

概要

$ZPOWER は、num パラメータの値の n 乗を返します。

この関数は、指数演算子 (**) と同様の処理を実行します 有効なパラメータ値、および特定のパラメータ値の組み合わせに対して返される値の詳細は、"Caché ObjectScript の使用法" の “演算子と式” の章にある "指数演算子" を参照してください。

パラメータ

num

累乗される数字。これには、整数、浮動少数点、負の数、正の数、またはゼロを指定します。Caché 標準の数値または IEEE 倍精度バイナリ浮動小数点数 ($DOUBLE 値) で指定できます。値、変数、式として指定することができます。

"Caché ObjectScript の使用法" の “データ型とデータ値” の章にある “数値としての文字列” で説明されているように、num を引用符付きの文字列として指定した場合、文字列は数値として解析されます。NULL 文字列 ("")、および数値以外の文字列は、ゼロに評価されます。

exponent

exponent には、整数、浮動少数点、負の数、正の数、またはゼロを指定します。Caché 標準の数値または IEEE 倍精度バイナリ浮動小数点数 ($DOUBLE 値) で指定できます。数値、文字列値、変数、式として指定することができます。

"Caché ObjectScript の使用法" の “データ型とデータ値” の章にある “数値としての文字列” で説明されているように、exponent を引用符付きの文字列として指定した場合、文字列は数値として解析されます。NULL 文字列 ("")、および数値以外の文字列は、ゼロに評価されます。

次のように numexponent を組み合わせるとエラーになります。

  • num が負の数の場合、exponent は整数である必要があります。整数でない場合は、<ILLEGAL VALUE> エラーが生成されます。

  • num が 0 の場合、exponent には正の数または 0 を指定する必要があります。 それ以外の数を指定すると、<ILLEGAL VALUE> エラーまたは <DIVIDE> エラーが生成されます。

  • $ZPOWER(9,153) のような大きな値を exponent に指定すると、オーバーフローが発生して <MAXNUMBER> エラーが生成されるか、アンダーフローが発生して 0 が返されることがあります。どちらの結果になるかは、num が 1 (または -1) よりも大きいか、および exponent が正か負かによって決まります。処理で Caché がサポートする最大数を超えた場合、<MAXNUMBER> エラーが発生します。詳細は、"Caché ObjectScript の使用法" の “データ型とデータ値” の章にある “極端に大きな数字” を参照してください。

有効なパラメータ値、および特定のパラメータ値の組み合わせに対して返される値の詳細は、"Caché ObjectScript の使用法" の “演算子と式” の章にある "指数演算子" を参照してください。

以下の例は、2 を 10 乗します。

  SET x=0
  WHILE x < 10 {
    SET rtn=$ZPOWER(2,x)
    WRITE !,"The ",x," power of 2=",rtn
    SET x=x+1 }

関連項目

FeedbackOpens in a new tab