ENTMF 

UVALID 関数

文字列が有効な Unicode UTF-8 または UTF-16 データで構成されている場合、UVALID 関数は値ゼロを返す。文字列に無効な Unicode データが含まれている場合、UVALID 関数は最初の無効な要素のインデックスを返す。

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

一般形式

引数

argument-1
英字、英数字、または各国文字でなければならない。

戻り値

戻り値は整数であり、次のとおり argument-1 の値に応じて異なる。
  • argument-1 の字類が英字または英数字で、UTF-8 にエンコードされた有効な Unicode データで構成されている場合、戻り値はゼロになる。
  • argument-1 の字類が英字または英数字で、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 コード ポイントの一部またはすべてが文字に割り当てられているかどうかを示すものではない。