HOWTO · C

如何在 C 語言中把字串轉換為整數

本文介紹了在 C 語言中把字串轉換為整數的不同方法。

本頁內容

將 C 字串轉換為整數時,適合的方法取決於你接受的輸入,以及程式需要進行哪些檢查。標準函式庫提供 atoi()、strtol() 和 strtoumax()。只有在輸入已可信任時才使用 atoi();若輸入可能格式錯誤,或超出目的型別的範圍,則建議使用 strtol() 或 strtoumax(),並檢查轉換結果。

在 C 語言中使用 atoi() 將字串轉換為整數

atoi() 宣告於 <stdlib.h>。它會略過前導空白,讀取選用的正負號與十進位數字,接著在遇到第一個不屬於數字的字元時停止。它會回傳 int,但介面不會指出解析停止的位置,也無法分辨有效的零與轉換失敗。如果轉換後的值無法用 int 表示,行為未定義。只有在輸入格式與數值範圍已由其他方式確保時,才應使用它。

執行以下範例:

本節中的程式碼以及顯示的標籤或輸出仍為英文。

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

int main(void) {
    const char *input = "123";
    int value = atoi(input);
    printf("%s -> %d\n", input, value);
    return 0;
}

以下是觀察到的輸出:

123 -> 123

範例中的英文輸出文字標籤維持原樣,與程式使用的字串一致。

在 C 語言中使用 strtol() 將字串轉換為整數

strtol() 宣告於 <stdlib.h>,並回傳 long。它接受 2 到 36 的進位基數;基數為 10 時會解析十進位數字,基數為 0 時則會辨識 C 語言常見的整數前綴。它會略過前導空白,並在遇到第一個不屬於數字的字元時停止。傳入尾端指標的位址即可取得停止位置。如果尾端指標仍指向輸入的第一個字元,表示沒有轉換任何數字;如果轉換後它指向非空字元,表示輸入末尾還有其他內容。

呼叫 strtol() 前,先將 errno 設為零。若結果等於 LONG_MIN 或 LONG_MAX,且 errno == ERANGE,表示數值超出 long 的範圍。如果目的型別是 int,轉型前也要檢查數值是否介於 INT_MIN 與 INT_MAX 之間。以下完整範例只接受能以 int 表示的完整十進位數值:

本節中的程式碼以及顯示的標籤或輸出仍為英文。

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

int main(void) {
    const char *input = "123";
    char *end;
    errno = 0;
    long parsed = strtol(input, &end, 10);

    if (end == input || *end != '\0' || errno == ERANGE ||
        parsed < INT_MIN || parsed > INT_MAX) {
        puts("conversion failed");
        return 0;
    }

    printf("value=%d\n", (int)parsed);
    return 0;
}

以下是觀察到的輸出:

value=123

在正式程式中,應先決定是否接受周圍的空白或末尾的其他內容;strtol() 本身允許前導空白,而上方的尾端指標檢查會拒絕數字後的任何內容。範例中的英文輸出文字標籤維持原樣。

在 C 語言中使用 strtoumax() 將字串轉換為整數

strtoumax() 宣告於 <inttypes.h>,會將字串轉換為 uintmax_t,也就是實作所提供的最大寬度無號整數型別。和 strtol() 一樣,它接受尾端指標與進位基數;清除 errno 後,若發生範圍溢位,會透過 errno == ERANGE 回報。使用 uintmax_t 型別需要包含 <stdint.h>;使用此函式與 PRIuMAX 格式巨集則需要包含 <inttypes.h>。

無號轉換可以接受開頭的負號,並依照函式規則產生無號結果。如果應用程式要求輸入必須是非負數,請明確拒絕負號。以下範例也要求至少轉換一個數字、拒絕數字後的其他字元,並使用相符的格式巨集輸出數值:

本節中的程式碼以及顯示的標籤或輸出仍為英文。

#include <ctype.h>
#include <errno.h>
#include <inttypes.h>
#include <stdint.h>
#include <stdio.h>
#include <stdlib.h>

int main(void) {
    const char *input = "123";
    const char *sign = input;
    while (isspace((unsigned char)*sign)) {
        ++sign;
    }

    if (*sign == '-') {
        puts("conversion failed");
        return 0;
    }

    char *end;
    errno = 0;
    uintmax_t value = strtoumax(input, &end, 10);
    if (end == input || *end != '\0' || errno == ERANGE) {
        puts("conversion failed");
        return 0;
    }

    printf("value=%" PRIuMAX "\n", value);
    return 0;
}

以下是觀察到的輸出:

value=123

範例中的英文輸出文字標籤維持原樣,與程式使用的字串一致。結果型別是無號整數,且寬度可能大於 int;轉換成較窄型別前,請先確認數值不超過目的型別的最大值。

如何選擇 C 語言的字串轉整數函式

當輸入可信任、可用 int 表示,而且程式不需要分辨格式錯誤的輸入與零時,請選擇 atoi()。對於使用者輸入、檔案或其他可能不符合預期格式的資料,strtol() 通常是較合適的有號整數轉換函式,因為可利用它的尾端指標與 errno 驗證輸入。請同時檢查 long 的範圍,以及任何較窄目的型別的範圍。

對於可能超過 long 正值範圍的非負數,請選擇 strtoumax()。確認至少轉換了一個數字;若整個字串都必須是數字,請拒絕末尾的其他文字;也要檢查 ERANGE,並遵守應用程式對較窄型別設定的限制。這兩個具備錯誤檢查能力的函式都不會替應用程式決定哪些輸入可以接受:呼叫端必須自行定義是否允許空白、正負號、前綴或末尾的其他字元,並在使用結果前驗證這些規則。