Len 関数 (LotusScript 言語)

構文

Len ( { stringExpr | variantExpr | numericExpr | typeName } )

要素

stringExpr

任意の文字列式。

variantExpr

変数名を含む任意の Variant 型の式です。

numericExpr

変数、配列の要素、リストの要素、またはユーザー定義のデータ型やクラスのメンバ変数の名前です。numericExpr のデータ型は数値です。

typeName

ユーザー定義のデータ型のインスタンスです。その型の単純な変数、またはその型の配列変数やリスト変数の要素を指定できます。

戻り値

stringExpr の場合、Len は文字列式の文字数を返します。

variantExpr の場合、Len は String 型に変換された variantExpr の値を格納するために必要な文字数を返します。

numericExpr の場合、Len は numericExpr の内容を格納するために必要なバイト数を返します。

typeName の場合、ユーザー定義のデータ型に Variant 型や可変長 String 型のメンバが含まれていない限り、Len はすべてのメンバ変数の内容を格納するために必要なバイト数を返します。その場合、ユーザー定義データ型の変数の長さは、そのメンバ変数の長さの合計と同じにならないことがあります。

使用法

LotusScript® のリリース 3 以降では、Len(NULL) はエラーとなります。それ以前のリリースの LotusScript では、Len(NULL) は NULL を返していました。

v が EMPTY の場合、Len(v) はゼロを返します。

LenB 関数を使用すると、文字列の長さを文字数ではなくバイト数で調べられます。LenBP 関数を使用すると、プラットフォーム固有の文字セットによる文字列の長さをバイト単位で調べられます。

例