文字列が有効な Unicode UTF-8 または UTF-16 データで構成されている場合、UVALID 関数は値ゼロを返す。文字列に無効な Unicode データが含まれている場合、UVALID 関数は最初の無効な要素の指標を返す。
一般形式
引数
- argument-1 の字類は英字、英数字、各国文字、または UTF-81 とする。
戻り値
- 戻り値は整数であり、次のとおり argument-1 の値に応じて異なる。
- argument-1 の字類が英字、英数字、または UTF-8 であり、UTF-8 で符号化された有効な Unicode データで構成されている場合、戻り値はゼロになる。
- argument-1 の字類が英字、英数字、または UTF-8 であり、UTF-8 で符号化された無効な Unicode データが含まれている場合、戻り値は無効な UTF-8 データが開始される先頭バイトの位置になる。
- argument-1 の字類が各国文字であり、UTF-16 で符号化された有効な Unicode データで構成されている場合、戻り値はゼロになる。
- argument-1 の字類が各国文字であり、UTF-16 で符号化された無効な Unicode データが含まれている場合、戻り値は無効な UTF-16 データが開始される先頭の UTF-16 符号化単位の位置になる。この位置は、無効なデータの前にある適正な UTF-16 符号化単位数に 1 を足した結果である。
注: UVALID 関数は、文字列が適正な Unicode UTF-8 または UTF-16 データで構成されているかどうかを示す。文字列が表す Unicode コード ポイントの一部またはすべてが文字に割り当てられているかどうかを示すものではない。