ULENGTH

この関数の型は整数である。

引数

argument-1

英字、英数字、または UTF-8¹ の UTF-8 にエンコードされた有効な文字で構成される文字列か、各国文字の UTF-16 にエンコードされた有効な文字で構成される文字列とする。

戻り値

戻り値は argument-1の UTF-8 文字または UTF-16 文字の数である。

注

argument-1 が UTF-16 データを含む各国文字データ項目で、argument-1 にサロゲート ペアが含まれている場合、下位と上位のペアごとに 1 つの UTF-16 文字として数えられる。

UTF-8 の引数に合成文字 (ä、ê、ü など) が含まれている場合、長さを求める際には結合文字が別々に数えられる。次の例のとおり、合成文字によって戻り値が変わることがある。