C 語言字串轉數值：strtol 多進制解析完全指南

編輯：關於C語言

為什麼選擇 strtol？

atoi、atol 只支援十進制且無錯誤回報。strtol 是功能最完整的字串轉長整數函數：

支援 2~36 進制（含自動偵測 0x/0 前綴）
提供 endptr 回報解析停止位置，可偵測無效字元
溢位時設定 errno = ERANGE 並回傳 LONG_MAX/MIN

函數原型

#include <stdlib.h>

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

參數	說明
`nptr`	待轉換字串，前導空白會被跳過
`endptr`	非 `NULL` 時，回傳第一個無效字元位址
`base`	進制（2~36 或 0）。0 表示自動偵測：`0x`→16、`0`→8、其他→10

實作範例

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

int main()
{
    char a[] = "100";
    char b[] = "100";
    char c[] = "0x11";
    char d[] = "   -123abc";
    char *pos;
    long x, y, z, w;

    x = strtol(a, NULL, 10);  // 十進制 100
    y = strtol(b, NULL, 2);   // 二進制 100 → 4
    z = strtol(c, NULL, 16);  // 十六進制 0x11 → 17
    w = strtol(d, &pos, 10);  // -123，pos 指向 'a'

    printf("x=%ld, y=%ld, z=%ld, w=%ld\n", x, y, z, w);
    printf("剩餘字串: \"%s\"\n", pos);

    // 錯誤檢查範例
    errno = 0;
    long val = strtol("9999999999999999999", NULL, 10);
    if (errno == ERANGE) printf("溢位！\n");

    return 0;
}

輸出：

x=100, y=4, z=17, w=-123
剩餘字串: "abc"

strtol vs atoi 關鍵差異

特性	atoi	strtol
進制支援	僅 10 進制	2~36 進制 + 自動偵測
錯誤回報	無（返回 0 無法區分 "0" 與 "abc"）	`endptr` + `errno`
溢位處理	未定義行為	飽和至 `LONG_MAX/MIN` + `ERANGE`
尾隨字元	忽略	透過 `endptr` 精確定位