NUMCHARS

NUMCHARSファンクションは、テキスト式の文字数をカウントします。値が複数行のテキスト値である場合、NUMCHARSはすべての行の合計文字数を返します。NUMCHARSによって返される結果のディメンションは、指定した式のディメンションと同じです。

ヒント:

マルチバイト・キャラクタ・セットを使用している場合、NUMCHARSファンクションのかわりにNULLIFファンクションを使用できます。

戻り値

INTEGER

構文

NUMCHARS(text-expression)

パラメータ

text-expression: 文字数がカウントされるテキスト式。NUMCHARSは、TEXT引数またはNTEXT引数を受け入れます。どちらのデータ型にも自動変換は行われません。指定した引数のデータ型に対応した情報が返されます。

例

例8-43 最長の名前の文字数のカウント

レポートのラベル列に適切な幅を指定するために、製品の名前の長さを調べるとします。NUMCHARSファンクションとLARGESTファンクションを組み合せて使用すると、最長のラベルの長さがわかります。その値を使用して列のサイズを設定します。プログラムの次の文は、最長の名前を検索し、その文字数を使用してレポートの書式を設定します。

firstcol = LARGEST(NUMCHARS(name.product))+1
LIMIT month TO FIRST 3
FOR product
   DO
     ROW WIDTH FIRSTCOL name.product WIDTH 6 ACROSS month - 
     FIRST 3: units
   DOEND

プログラムを実行すると、次の出力が生成されます。

3-Person Tents      200    203    269
Aluminum Canoes     347    400    482
Tennis Racquets     992  1,076  1,114
Warm-up Suits     1,096  1,214  1,294
Running Shoes     2,532  2,405  2,775