ULENGTH 関数は、UTF-8 または UTF-16 のデータを含む文字列内の UTF-8 文字または UTF-16 文字の数と等しい整数値を返す。
一般形式
引数
- argument-1
- 英字、英数字、または UTF-81 の UTF-8 にエンコードされた有効な文字で構成される文字列か、各国文字の UTF-16 にエンコードされた有効な文字で構成される文字列とする。
戻り値
戻り値は argument-1の UTF-8 文字または UTF-16 文字の数である。
注
argument-1 が UTF-16 データを含む各国文字データ項目で、argument-1 にサロゲート ペアが含まれている場合、下位と上位のペアごとに 1 つの UTF-16 文字として数えられる。
UTF-8 の引数に合成文字 (ä、ê、ü など) が含まれている場合、長さを求める際には結合文字が別々に数えられる。次の例のとおり、合成文字によって戻り値が変わることがある。
文字 |
Unicode エンコーディング |
UTF-8 エンコーディング |
戻り値 |
ä |
U+00E4
(合成済み形式、分音記号付きのラテン小文字 a)
|
x'C3A4’ |
1 |
U+0061 + U+0308
(正準分解、ラテン小文字 a + 結合分音記号)
|
x'61CC88' |
2 |