wcstol(3C)

構文

#include <wchar.h>

long int wcstol(const wchar_t *nptr, wchar_t **endptr, int base);

long long wcstoll(const wchar_t *nptr, wchar_t **endptr, int base);

unsigned long int wcstoul(const wchar_t *nptr, wchar_t **endptr,
int base);

unsigned long long wcstoull(const wchar_t *nptr, wchar_t **endptr,
int base);

説明

wcstol() または wcstoul() は、 nptr が指すワイドキャラクタ文字列を long int または unsigned long int の数値にそれぞれ変換します。 wcstoll() または wcstoull() は、 nptr が指すワイドキャラクタ文字列を long long または unsigned long long の数値にそれぞれ変換します。 この文字列を先頭から、基数 base に対して不適切なワイドキャラクタが現れるまで走査します。 文字列の先頭の「空白」ワイドキャラクタ wctype(3C) の iswspace() によって定義) は無視します。 変換できなかった場合には、戻り値は ０ となります。

base が ２ 以上で 36 以下の場合、これを基数とします。 先頭には、オプションので符号をつけることができます。 この後ろに ０ があっても無視されます。 base が 16 の場合には、 0x や 0X も無視します。

base が ０ の場合、基数はワイドキャラクタ文字列自体から判断します。先頭のオプションの符号の次に ０ があった場合は ８ 進数とし、 0x や 0X があった場合は 16 進数とし、それ以外の場合は 10 進数として変換します。

endptr の値が (wchar_t **)NULL でない場合、 変換のための走査を終了する原因となったワイドキャラクタへのポインターを endptr が指す場所に格納します。 整数への変換を何もしなかった場合、 endptr が指す場所には、 nptr が格納され、戻り値は ０ となります。

これらの関数と wchar_t 型は、ヘッダーファイル <wchar.h> で定義してあります。

多言語化対応

戻り値

正常終了の場合、どちらの関数も変換した値があればそれを戻り値とします。

正しい変換値がオーバーフローを起こす場合、

その他のエラーについては戻り値は ０ となり、 errno をエラーに従って設定します。

エラー

wcstol()、 wcstoul()、 wcstoll()、 および wcstoull() は、次の条件のどれかに当てはまった場合は失敗し、 errno を対応する値に設定します。

著者

これらのインタフェースは、OSF と HP で開発されました。

参照

wctype(3C), wcstod(3C), wcstoimax(3C), scanf(3S), thread_safety(5)

標準準拠

wcstol(): XPG4

wcstoul(): XPG4

wcstoll(): C99

wcstoull(): C99 !> .