STATVALファンクションは、ディメンションまたはディメンション・サロゲートの現行のステータス・リストで指定した位置、あるいは値セットで指定した位置に対応するディメンション値を返します。
戻り値
STATVALが返すデータ型は、ディメンション値またはディメンション・サロゲート値のデータ型、あるいはディメンションのデフォルトのステータス・リストでの位置を示すINTEGER
です。STATVALが返すディメンション値は、コンテキストに合せて数値またはテキスト値に変換されます。STATVALが常にINTEGER
値を返すようにするには、INTEGERキーワードを指定します。例8-118「常にINTEGERを返すSTATVALの設定」を参照してください。
構文
STATVAL(dimension position [INTEGER])
引数
値がディメンション、ディメンション・サロゲートまたは値セットの名前であるテキスト式。
ディメンションまたは値セットの現行のステータス・リストでの位置を指定するINTEGER
式。値を持たない位置を指定すると、STATVALはNA
を返します。
デフォルトのステータス・リストでのディメンション値の位置を示すINTEGER
をSTATVALが常に返すように指定します。
注意
FORループのSTATVAL
ディメンションに対するFORループでは、ループの反復ごとにステータスが単一のディメンション値に制限されます。このため、STATVALは位置1
の値のみを返します。他の位置にはNA
を返します。
例
例8-117 修飾データ参照を持つ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