UWIDTH

UWIDTH 関数は、UTF-8 または UTF-16 で符号化された文字列引数の n 番目の UTF-8 文字または UTF-16 文字のバイト幅と等しい整数値を返す。

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

一般形式

引数

argument-1

英字、英数字、各国文字、または UTF-8 とする。argument-1 は次のとおり、字類に応じて有効な UTF-8 または UTF-16 データで構成されている必要がある。

argument-1 の字類が英字、英数字、または UTF-8 の場合、有効な UTF-8 データで構成されていなければならない。
argument-1 の字類が各国文字の場合、有効な UTF-16 データで構成されていなければならない。

argument-2

argument-1 の位置を示す n 番目の UTF-8 文字または UTF-16 文字。argument-2 は正の整数でなければならず、ULENGTH(argument-1) を超えてはならない。超えた場合はゼロが返される。

返却値

返却値は、argument-1 の n 番目の文字のバイト幅を表す整数である。

説明

この関数は表意文字異体字セレクター (IVS) をサポートし、フォントソフトウェアでデフォルトとは異なる字形を選択できる (異体字が存在しないかサポートされていない場合はフォントソフトウェアで無視される)。IVS は U-E0100 から U-E01EF の範囲の Unicode 文字で構成される。UTF-16 文字列は U-DB40 + DD00 から U-DB40 + DDEF の範囲のサロゲートペアを使用し、UTF-8 文字列は 0xF3A08480 から 0xF3A087AF の範囲を使用する。

Unicode 文字の後に IVS が続く場合、この関数の処理において 1 文字として扱われる。