STRTOUL

Section: Linux Programmer's Manual (3)
Updated: 2020-11-01
Index JM Home Page roff page
 

名前

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

書式

#include <stdlib.h>

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

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

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

strtoull():

_ISOC99_SOURCE ||
    || /* Glibc versions <= 2.19: */ _SVID_SOURCE || _BSD_SOURCE
 

説明

strtoul() 関数は、 nptr の文字列の最初の部分を、 base を基数として unsigned long に変換する。 この base は 2 から 36 までの値 あるいは特別な意味を持つ値 0 でなければならない。

文字列の先頭には、任意の数の空白があってもよく (空白は isspace(3) で判定される)、また数字の直前には '+' か '-' の 符号があってもよい。 base が 0 または 16 の場合には、文字列の先頭に "0x" を置くことが でき、その場合には文字列は 16進数として扱われる。 これ以外の文字列で base が 0 の場合は、 文字列が '0' で始まるときは 8進数として、 それ以外のときは 10進数として扱われる。

文字列の残りの部分は unsigned long に変換されるが、基数に対して 有効でない数字が現れた時点で変換は終了する。(11進数以上では 'A' は 大文字・小文字に関わらず 10 を表し、 'B' は 11 を表現し, 以下同様に、 'Z' は 35 を表す。)

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

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

返り値

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

エラー

EINVAL
(C99 にはない) 指定された base がサポートされていない値である。
ERANGE
結果の値が範囲外である。

実装によっては、変換が行われなかった場合 (数字がなく、0 を返した場合)、 errnoEINVAL が設定される場合がある。  

属性

この節で使用されている用語の説明については、 attributes(7) を参照。
インターフェース属性
strtoul(), strtoull(), strtouq() Thread safetyMT-Safe locale
 

準拠

strtoul(): POSIX.1-2001, POSIX.1-2008, C89, C99 SVr4.

strtoull(): POSIX.1-2001, POSIX.1-2008, C99.  

注意

strtoul () からは成功、失敗どちらの場合でも 0 や ULONG_MAX (strtoull() では ULLONG_MAX) が返る可能性があるので、 プログラムは関数を呼び出す前に errno を 0 に設定し、呼び出し後に errno が 0 以外の値かどうかを確認しエラーが発生したかどうかを判断する 必要がある。

"C" 以外のロケールの場合、その他の文字列も受け付けられるかもしれない。 (例えば、現在のロケールの 1000 毎の区切り文字に対応しているかもしれない。)

BSD には、

u_quad_t strtouq(const char *nptr, char **endptr, int base);

という完全に同様の定義を持つ関数がある。 使用中のアーキテクチャーのワード長次第であるが、この関数は strtoull() や stroul() と等価な場合もありえる。

負の値も正当な入力とみなされ、エラーもなく、 対応する unsigned long 型の値に変換される。  

strtol(3) のマニュアルページの例を参照。 このページで説明した関数の使用方法も同様である。  

関連項目

a64l(3), atof(3), atoi(3), atol(3), strtod(3), strtol(3), strtoumax(3)  

この文書について

この man ページは Linux man-pages プロジェクトのリリース 5.10 の一部である。プロジェクトの説明とバグ報告に関する情報は https://www.kernel.org/doc/man-pages/ に書かれている。


 

Index

名前
書式
説明
返り値
エラー
属性
準拠
注意
関連項目
この文書について

This document was created by man2html, using the manual pages.
Time: 16:46:43 GMT, November 24, 2023