std::strtol, std::strtoll

 

C++

編譯器支援

自由（freestanding）與宿主（hosted）

語言

標準庫

標準庫標頭檔案

具名要求

特性測試宏 (C++20)

語言支援庫

概念庫 (C++20)

診斷庫

記憶體管理庫

超程式設計庫 (C++11)

通用工具庫

容器庫

迭代器庫

範圍庫 (C++20)

演算法庫

字串庫

文字處理庫

數值庫

日期和時間庫

輸入/輸出庫

檔案系統庫 (C++17)

併發支援庫 (C++11)

執行控制庫 (C++26)

技術規範

符號索引

外部庫

 

文字處理庫

本地化庫

正則表示式庫 (C++11)

格式化庫 (C++20)

空終止序列工具

位元組字串

多位元組字串

寬字串

原生數值轉換

to_chars (C++17) to_chars_result (C++17) from_chars (C++17) from_chars_result (C++17) chars_format (C++17)

文字編碼標識

text_encoding (C++26)

 

空終止位元組字串

函式
字元分類
isalnum isalpha islower isupper isdigit isxdigit	isblank (C++11) iscntrl isgraph isspace isprint ispunct
字元操作
tolower	toupper
轉換為數字格式
atof atoiatolatoll (C++11) strtolstrtoll (C++11)	strtoulstrtoull (C++11) strtofstrtodstrtold (C++11)(C++11) strtoimaxstrtouimax (C++11)(C++11)
字串操作
strcpy strncpy strxfrm	strcat strncat
字串檢查
strlen strcmp strncmp strcoll strchr strrchr	strspn strcspn strpbrk strstr strtok
字元陣列函式
memchr memcmp memset	memcpy memmove
雜項
strerror

 

定義於標頭檔案 <cstdlib>
long      strtol( const char* str, char** str_end, int base );	(1)
long long strtoll( const char* str, char** str_end, int base );	(2)	(C++11 起)

解釋由 str 指向的位元組字串中的整數值。

丟棄所有空白字元（透過呼叫 std::isspace 識別），直到找到第一個非空白字元，然後儘可能多地獲取字元以形成有效的 *基數-n*（其中 n=base）整數表示，並將其轉換為整數值。有效的整數值包含以下部分

• (可選) 加號或減號
• (可選) 字首 (0) 表示八進位制基數（僅當基數為 8 或 ​0​ 時適用）
• (可選) 字首 (0x 或 0X) 表示十六進位制基數（僅當基數為 16 或 ​0​ 時適用）
• 一系列數字

基數的有效值集合是 {0, 2, 3, ..., 36}。基數-2 整數的有效數字集合是 {0, 1}，基數-3 整數的有效數字是 {0, 1, 2}，依此類推。對於大於 10 的基數，有效數字包括字母字元，從基數-11 整數的 Aa 到基數-36 整數的 Zz。字元的大小寫被忽略。

當前安裝的 C locale 可能會接受其他數字格式。

如果 base 的值為 ​0​，則自動檢測數字基數：如果字首是 0，則基數為八進位制；如果字首是 0x 或 0X，則基數為十六進位制；否則基數為十進位制。

如果減號是輸入序列的一部分，則從數字序列計算出的數值將被取反，如同結果型別中的一元減號。

該函式將 str_end 指向的指標設定為指向最後一個被解釋字元之後的字元。如果 str_end 是空指標，則忽略它。

如果 str 為空或不符合預期形式，則不執行轉換，並且（如果 str_end 不是空指標）str 的值儲存在 str_end 指向的物件中。

引數

str	-	指向要解釋的空終止位元組字串的指標
str_end	-	指向字元指標的指標
base	-	被解釋整數值的*基數*

返回值

• 如果成功，則返回與 str 內容對應的整數值。
• 如果轉換後的值超出相應返回型別的範圍，則發生範圍錯誤（將 errno 設定為 ERANGE），並返回 LONG_MAX、LONG_MIN、LLONG_MAX 或 LLONG_MIN。
• 如果無法執行轉換，則返回 ​0​。

示例

執行此程式碼

#include <cerrno>
#include <cstdlib>
#include <iomanip>
#include <iostream>
#include <string>
 
int main()
{
    const char* p = "10 200000000000000000000000000000 30 -40";
    std::cout << "Parsing " << std::quoted(p) << ":\n";
 
    for (;;)
    {
        // errno can be set to any non-zero value by a library function call
        // regardless of whether there was an error, so it needs to be cleared
        // in order to check the error set by strtol
        errno = 0;
        char* p_end{};
        const long i = std::strtol(p, &p_end, 10);
        if (p == p_end)
            break;
 
        const bool range_error = errno == ERANGE;
        const std::string extracted(p, p_end - p);
        p = p_end;
 
        std::cout << "Extracted " << std::quoted(extracted)
                  << ", strtol returned " << i << '.';
        if (range_error)
            std::cout << "\n  Range error occurred.";
 
        std::cout << '\n';
    }
}

可能的輸出

Parsing "10 200000000000000000000000000000 30 -40":
Extracted "10", strtol returned 10.
Extracted " 200000000000000000000000000000", strtol returned 9223372036854775807.
  Range error occurred.
Extracted " 30", strtol returned 30.
Extracted " -40", strtol returned -40.

另請參閱

stoistolstoll (C++11)(C++11)(C++11)	將字串轉換為有符號整數 (函式)
strtoulstrtoull (C++11)	將位元組字串轉換為無符號整數值 (函式)
strtoimaxstrtoumax (C++11)(C++11)	將位元組字串轉換為 std::intmax_t 或 std::uintmax_t (函式)
wcstolwcstoll	將寬字串轉換為整數值 (函式)
strtofstrtodstrtold	將位元組字串轉換為浮點值 (函式)
from_chars (C++17)	將字元序列轉換為整數或浮點值 (函式)
atoiatolatoll (C++11)	將位元組字串轉換為整數值 (函式)
C documentation for strtol, strtoll