MAXCHARS

MAXCHARSファンクションは、複数行のテキスト式の最も長い行の文字数をカウントするファンクションです。MAXCHARSによって返される結果のディメンションは、指定した式のディメンションと同じです。

ヒント:

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

戻り値

INTEGER

構文

MAXCHARS(text-expression)

パラメータ

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

例

例8-23 文字数を使用した最も長い行の長さの確認

mytextというテキスト変数の最も長い行の長さを確認するとします。次の例では、変数の値およびMAXCHARSによって返される結果が示されています。

次の文

SHOW mytext

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

This is a multiline text variable. 
The longest line is this one in the middle.
The third line is short.

次の文

SHOW MAXCHARS(mytext)

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