---

STATMAX

STATMAXファンクションは、ディメンションまたはディメンション・サロゲートの現行のステータス・リストの最新の値、あるいは値セットの最新の値を返します。

戻り値

STATMAXが返すデータ型は、ディメンション値またはディメンション・サロゲート値のデータ型、あるいはディメンションまたはサロゲートのデフォルトのステータス・リストでの位置を示すINTEGERです。「STATMAXで返されるディメンション値の自動変換」を参照してください。

構文

STATMAX(dimension)

引数

dimension

値がディメンション、ディメンション・サロゲートまたは値セットの名前であるテキスト式。

注意

STATMAXで返されるディメンション値の自動変換

STATMAXが返す値は、コンテキストに合せて数値またはテキスト値に変換されます。たとえば、monthのステータスがJun95〜Dec95に制限されており、Dec95がデフォルトのステータス・リストの12番目だとします。STATMAX(month)の値は、テキスト変数または数値変数に代入できます。

次の文を発行します。

DEFINE textvar TEXT
textvar = STATMAX(month)
SHOW textvar

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

Dec95

これに対し、次の文を発行します。

DEFINE intvar INTEGER
intvar = STATMAX(month)
SHOW intvar

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

12

例

例8-111 タイトルに使用するSTATMAX

次のプログラムの文は、STATMAXを使用して売上総額の下位10か月の中で一番最近の月を判別します。

LIMIT month TO BOTTOM 10 BASEDON TOTAL(sales, month)
SHOW JOINCHARS(STATMAX(month) ' is the latest month -
  of the ten months with the lowest sales.')
SHOW JOINCHARS('the months range from ' STATMIN(month) ' to '-
  STATMAX(month))

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

Dec96 is the latest month of the ten months with the lowest sales.
The months range from Jan95 to Dec96

LIMITコマンドによってmonthの値が時間順ではなく売上の昇順に並べられているため、STATMAXのかわりにSTATLASTを使用した場合は別の値が生成されます。