Manpages

名 前

strtoul, strtoull, strtouq − 文 字 列 を unsigned long int に 変 換 す る

書 式

#include <stdlib.h>

unsigned long int strtoul(const char *nptr, char **endptr, int base);

unsigned long long int strtoull(const char *nptr, char **endptr,
int base);

glibc 向 け の 機 能 検 査 マ ク ロ の 要 件 (feature_test_macros(7) 参 照 ):

strtoull():

XOPEN_SOURCE >= 600 || _BSD_SOURCE || _SVID_SOURCE || _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L; ま た は cc −std=c99

説 明

strtoul() 関 数 は 、 nptr の 文 字 列 の 最 初 の 部 分 を 、 base を 基 数 と し て unsigned long int に 変 換 す る 。 こ の base は 2 か ら 36 ま で の 値 あ る い は 特 別 な 意 味 を 持 つ 値 0 で な け れ ば な ら な い 。 文 字 列 の 先 頭 に は 、 任 意 の 数 の 空 白 が あ っ て も よ く (空 白 は isspace(3) で 判 定 さ れ る )、 ま た 数 字 の 直 前 に は '+' か '−' の 符 号 が あ っ て も よ い 。 base が 0 ま た は 16 の 場 合 に は 、 文 字 列 の 先 頭 に "0x" を 置 く こ と が で き 、 そ の 場 合 に は 文 字 列 は 16進 数 と し て 扱 わ れ る 。 こ れ 以 外 の 文 字 列 で base が 0 の 場 合 は 、 文 字 列 が '0' で 始 ま る と き は 8進 数 と し て 、 そ れ 以 外 の と き は 10進 数 と し て 扱 わ れ る 。 文 字 列 の 残 り の 部 分 は unsigned long int に 変 換 さ れ る が 、 基 数 に 対 し て 有 効 で な い 数 字 が 現 れ た 時 点 で 変 換 は 終 了 す る 。 (11進 数 以 上 で は 'A' は 大 文 字 ・ 小 文 字 に 関 わ ら ず 10 を 表 し 、 'B' は 11 を 表 現 し , 以 下 同 様 に 、 'Z' は 35 を 表 す 。 )

endptr が ヌ ル 値 (NULL) で な い 場 合 、 strtoul() は 最 初 に 不 正 な 文 字 が 現 れ た ア ド レ ス を *endptr に 格 納 し て い る 。 文 字 列 に 有 効 な 数 字 が ひ と つ も な け れ ば 、 strtoul() は nptr の 元 の 値 を *endptr に 代 入 す る (そ し て 0 を 返 す )。 特 に 、 *nptr が '\0' 以 外 で 、 返 さ れ た **endptr が '\0' な ら ば 、 文 字 列 全 体 が 有 効 だ っ た こ と に な る 。

strtoull() 関 数 は strtoul() 関 数 と 同 様 だ が 、 unsigned long long int 型 の 値 を 返 す 。

返 り 値

strtoul() 関 数 は 変 換 結 果 を 返 す 。 文 字 列 が マ イ ナ ス 符 号 か ら 始 ま っ て い た 場 合 は 、 (符 号 反 転 前 の 値 が オ ー バ ー フ ロ ー し て い な け れ ば ) 変 換 結 果 を 符 号 反 転 し た 値 を unsigned 型 で 返 す 。 変 換 で オ ー バ ー フ ロ ー が 発 生 し た 場 合 は ULONG_MAX を 返 し 、 errno に ERANGE を 設 定 す る 。 (ULONG_MAX を ULLONG_MAX と 読 み 替 え れ ば ) strtoull() は strtoul() と 全 く 同 じ で あ る 。

エ ラ ー