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)

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