Cライブラリ関数 -strtol()

C 标准库 - <stdlib.h>C標準ライブラリ - <stdlib.h>

説明

Cライブラリ関数long int strtol(const char *str, char **endptr, int base)引数strが指す文字列を、指定されたbasebase に基づいて long int 型の長整数に変換します。base は 2 から 36(両端を含む)の間、または特別な値 0 でなければなりません。

宣言

以下は strtol() 関数の宣言です。

long int strtol(const char *str, char **endptr, int base)

引数

  • str-- long int 型に変換する文字列。
  • endptr-- 型 char* のオブジェクトへの参照であり、その値は関数によってstr文字列中の数値の次の文字に設定されます。
  • base-- 基数であり、2 から 36(両端を含む)の間、または特別な値 0 でなければなりません。base が 0 の場合、文字列の接頭辞に基づいて基数が判断されます。文字列が '0x' または '0X' で始まる場合は 16 進数とみなされ、文字列が '0' で始まる場合は 8 進数とみなされ、それ以外の場合は 10 進数とみなされます。

戻り値

関数は変換された long 型整数値を返します。入力文字列が数値形式に一致しない場合、strtol() は 0 を返します。変換結果が long 整数の表現範囲を超えると、オーバーフローが発生し、errno が ERANGE に設定されます。<errno.h> ヘッダーファイルの errno 変数を使用して、オーバーフローが発生したかどうかを確認できます。

例

以下の例は strtol() 関数の使い方を示しています。

次の例では、文字列 "12345" を long 型整数に変換します。strtol() 関数はこの文字列を対応する整数値 12345 に変換します。base に 10 を指定したため、10 進数として変換されます。

例

#include <stdio.h>
#include <stdlib.h>

int main() {
    char str[] = "12345";
    char *endptr;
    long int num;

    num = strtol(str, &endptr, 10);

    if (*endptr != '\0') {
        printf("変換失敗:入力文字列は有効な整数ではありません。\n");
    } else {
        printf("変換結果:%ld\n", num);
    }

    return 0;
}

上のプログラムをコンパイルして実行すると、次の結果が得られます:

转换结果:12345

入力文字列を完全に整数に変換できない場合、strtol() 関数は変換に成功した部分を返し、endptr は変換されなかった部分の最初の文字を指します。この例では、endptr は文字列の末尾のヌル文字 '\0' を指しており、入力文字列全体が正常に整数に変換されたことを示しています。

入力文字列に数字以外の文字が含まれている場合、例えば "12ab" の場合、endptr は "ab" の開始位置を指し、変換が失敗したことを示します。

例

#include <stdio.h>
#include <stdlib.h>

int main() {
    char str[] = "12ab";
    char *endptr;
    long int num;

    num = strtol(str, &endptr, 10);

    if (*endptr != '\0') {
        printf("変換失敗:入力文字列は有効な整数ではありません。未変換部分:%s\n", endptr);
    } else {
        printf("変換結果:%ld\n", num);
    }

    return 0;
}

上記の例では、文字列 "12ab" を long 型整数に変換します。strtol() 関数はこの文字列を対応する整数値 12 に変換しようとしますが、文字列に数字以外の文字 "ab" が含まれているため、変換は完了しません。

出力は次のようになります:

转换失败:输入字符串不是一个有效的整数。未转换部分:ab

C 标准库 - <stdlib.h>C標準ライブラリ - <stdlib.h>

その他の拡張