LenB 関数 (LotusScript 言語)

文字列の長さを示すバイト数、または変数を格納するのに必要なバイト数を返します。

構文

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

要素

stringExpr

任意の文字列式。

variantExpr

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

numericExpr

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

typeName

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

戻り値

stringExpr の場合、LenB は文字列式のバイト数を返します。

variantExpr の場合、LenB は String 型に変換された variantExpr の値を格納するのに必要なバイト数を返します。

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

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

使用法

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

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

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