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 文字として扱われる。