#include <stdlib.h> long strtol(const char *nptr, char **endptr, int base); long long strtoll(const char *nptr, char **endptr, int base);
glibc 向けの機能検査マクロの要件 (feature_test_macros(7) 参照):
strtoll():
文字列の先頭には、任意の数の空白があってもよく (空白は isspace(3) で判定される)、また数字の直前には '+' か '-' の 符号があってもよい。 base が 0 または 16 の場合には、文字列の先頭に "0x" か "0X" を置くことが でき、その場合には文字列は 16進数として扱われる。 これ以外の文字列で base が 0 の場合は、 文字列が '0' で始まるときは 8進数として、 それ以外のときは 10進数として扱われる。
数字を表す文字列は long に変換されるが、基数に対して 有効でない数字が現れた時点で変換は終了する。(11進数以上では 'A' は 大文字・小文字に関わらず 10 を表し、 'B' は 11 を表現し、 以下同様に、 'Z' は 35 を表す。)
endptr がヌル値 (NULL) でない場合は、最初に現れた不正な文字が strtol() によって *endptr に保存されている。 文字列に有効な数字がひとつもなければ、 strtol() は nptr の元の値を *endptr に代入する (そして 0 を返す)。 特に、*nptr が '\0' 以外で、返された **endptr が '\0' ならば、文字列全体が有効だったことになる。
strtoll() 関数は strtol() と同様だが、 long long 型の値を返す。
実装によっては、変換が行われなかった場合 (数字がなく、0 を返した場合)、 errno に EINVAL が設定される場合がある。
インターフェース | 属性 | 値 |
strtol(), strtoll(), strtoq() | Thread safety | MT-Safe locale |
strtoll(): POSIX.1-2001, POSIX.1-2008, C99.
POSIX.1 では、 "C" と "POSIX" 以外のロケールでは、これらの関数は、他の実装時に定義される数字を示す文字列を受け付けるとされている。
BSD には、
quad_t strtoq(const char *nptr, char **endptr, int base);
という完全に同様の定義を持つ関数がある。 使用中のアーキテクチャーのワード長次第であるが、この関数は strtoll() か strtol() と等価となることもある。
$ ./a.out 123 strtol() returned 123 $ ./a.out ' 123' strtol() returned 123 $ ./a.out 123abc strtol() returned 123 Further characters after number: "abc" $ ./a.out 123abc 55 strtol: Invalid argument $ ./a.out '' No digits were found $ ./a.out 4000000000 strtol: Numerical result out of range
int
main(int argc, char *argv[])
{
int base;
char *endptr, *str;
long val;
if (argc < 2) {
fprintf(stderr, "Usage: %s str [base]\n", argv[0]);
exit(EXIT_FAILURE);
}
str = argv[1];
base = (argc > 2) ? atoi(argv[2]) : 0;
errno = 0; /* To distinguish success/failure after call */
val = strtol(str, &endptr, base);
/* Check for various possible errors */
if (errno != 0) {
perror("strtol");
exit(EXIT_FAILURE);
}
if (endptr == str) {
fprintf(stderr, "No digits were found\n");
exit(EXIT_FAILURE);
}
/* If we got here, strtol() successfully parsed a number */
printf("strtol() returned %ld\n", val);
if (*endptr != '\0') /* Not necessarily an error... */
printf("Further characters after number: \"%s\"\n", endptr);