Rational Developer for System z
Enterprise PL/I for z/OS, Version 3.8, 言語解説書

UPOS

UPOS は、ストリング内の n 番目の UTF 文字の索引である FIXED BIN(31) 値を返します。

構文図を読む構文図をスキップする>>-UPOS(x,n)---------------------------------------------------><
 
x
CHARACTER または WIDECHAR タイプが必要な式。
n
計算タイプで、必要に応じて FIXED BIN(31) に変換される式。

x が CHARACTER タイプである場合、ストリングには有効な UTF-8 データが入っている必要があります。 そうでない場合は、ERROR 条件が発生します。

x が WIDECHAR タイプである場合、ストリングには有効な UTF-16 データが入っている必要があります。 そうでない場合は、ERROR 条件が発生します。

n が正ではない場合、または n が ULENGTH(x) より大きい場合は、ゼロが返されます。 それ以外の場合は、x が CHARACTER タイプの場合は、UPOS(x,n) は n 番目の UTF-8 文字が開始するバイトの位置を返し、 x が WIDECHAR タイプの場合は、UPOS(x,n) は n 番目の UTF-16 文字が開始するワイド文字の位置を返します。

例えば、x が CHARACTER ストリング '4b_c3_a4_66_65_72'x である場合には、次のようになります。


Terms of use | Feedback

This information center is powered by Eclipse technology. (http://www.eclipse.org)