STATVAL

STATVALファンクションは、ディメンションまたはディメンション・サロゲートの現行のステータス・リストで指定した位置、あるいは値セットで指定した位置に対応するディメンション値を返します。

戻り値

STATVALが返すデータ型は、ディメンション値またはディメンション・サロゲート値のデータ型、あるいはディメンションのデフォルトのステータス・リストでの位置を示すINTEGERです。STATVALが返すディメンション値は、コンテキストに合せて数値またはテキスト値に変換されます。STATVALが常にINTEGER値を返すようにするには、INTEGERキーワードを指定します。例8-120「常にINTEGERを返すSTATVALの設定」を参照してください。

構文

STATVAL(dimension position [INTEGER])

パラメータ

dimension: 値がディメンション、ディメンション・サロゲートまたは値セットの名前であるテキスト式。
position: ディメンションまたは値セットの現行のステータス・リストでの位置を指定するINTEGER式。値を持たない位置を指定すると、STATVALはNAを返します。
INTEGER: デフォルトのステータス・リストでのディメンション値の位置を示すINTEGERをSTATVALが常に返すように指定します。

使用上の注意

FORループのSTATVAL

ディメンションに対するFORループでは、ループの反復ごとにステータスが単一のディメンション値に制限されます。このため、STATVALは位置1の値のみを返します。他の位置にはNAを返します。

例

例8-119 修飾データ参照を持つSTATVAL

売上総額の上位10か月のうち、5番目の月の売上額を確認するとします。monthをTOP 10に制限してから、修飾データ参照のSTATVALを使用して5番目の月の売上額を生成します。

LIMIT month TO TOP 10 BASEDON TOTAL(sales, month)
REPORT month

この文によって生成されるレポートは次のとおりです。

MONTH
--------------
Jul96
Jun96
Jul95
Aug96
Jun95
Sep96
May96
Aug95
Sep95
MAY95

次のようにSTATVALをREPORT文で使用すると、別のレポートが生成されます。

REPORT W 8 DOWN district HEADING -
   JOINCHARS('Sales: 5th of Top Ten - ' STATVAL(month 5)) -
   sales(month STATVAL(month 5))

この文によって生成されるレポートは、次のとおりです。

         ------------Sales: 5th of Top Ten - Jun95-------------
         -----------------------PRODUCT------------------------
DISTRICT   Tents      Canoes    Racquets  Sportswear  Footwear
-------- ---------- ---------- ---------- ---------- ----------
Boston    88,996.35 147,412.44  90,840.60  75,206.30 144,162.66
Atlanta  110,765.24 106,327.17 109,695.31 155,652.78 146,364.99
Chicago   70,908.96 108,039.05 100,030.29 104,900.66 148,386.81
Dallas   128,692.56  71,899.23 176,452.58 164,823.10  32,421.25
Denver    91,717.46  99,099.20 140,961.37  99,951.60  70,149.77
Seattle  113,806.48 143,037.62  54,926.87  57,739.03  75,457.04

次の文の修飾データ参照は「monthのデフォルトのステータスにある5番目の月の売上」を意味します。

sales(month 5)

次の文の修飾データ参照は「monthの現行のステータスにある5番目の月の売上」を意味します。

sales(month STATVAL(month 5))

次の文は、monthの修飾データ参照で返される値、および引数monthを持つSTATVALで返される値を表示します。

SHOW month(month 5)
SHOW STATVAL(month 5)

この文によって生成される出力は、次のとおりです。

May95
Jun95

例8-120 常にINTEGERを返すSTATVALの設定

コンテキストによって、STATVALはINTEGERキーワードを指定しなくてもINTEGER値を返す場合があります。

次の文

LIMIT month TO 'Jun95' TO 'Dec95'
SHOW STATVAL(month 3)

によって、次の出力が生成されます。

Aug95

INTEGERキーワードを付けます。

SHOW STATVAL(month 3 INTEGER)

生成される出力は次のとおりです。