function template
<string>

std::stoul

unsigned long stoul (const string&  str, size_t* idx = 0, int base = 10);unsigned long stoul (const wstring& str, size_t* idx = 0, int base = 10);
將字串轉換為無符號整數
解析str，將其內容解釋為指定base的整數，並返回unsigned longlong int

的值返回。如果idx不是空指標，函式還會將idx的值設定為str中數字之後第一個字元的位置。

該函式使用 strtoul（或 wcstoul）進行轉換（有關轉換過程的更多詳細資訊，請參見 strtol）。

引數

str
具有整型數字表示的字串物件。
idx
指向型別為 size_t 的物件的指標，其值由函式設定為str中數值之後下一個字元的位置。
該引數也可以是一個空指標，此時它將不被使用。
base
決定有效字元及其解釋的數字基數（radix）。
如果這個是0，則使用的基數由序列中的格式確定（有關詳細資訊，請參閱strtol）。請注意，預設情況下此引數為10，而不是0.

返回值

成功時，該函式將其轉換後的整型數字作為unsigned longlong int

示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
 
// stoul example
#include <iostream>   // std::cin, std::cout
#include <string>     // std::string, std::stoul, std::getline

int main ()
{
  std::string str;
  std::cout << "Enter an unsigned number: ";
  std::getline (std::cin,str);
  unsigned long ul = std::stoul (str,nullptr,0);
  std::cout << "You entered: " << ul << '\n';
  return 0;
}

複雜度

未定義，但通常與解釋的字元數呈線性關係。

資料競爭

修改idx指向的值 (如果idx不為零)。

異常

如果無法執行任何轉換，則丟擲invalid_argument異常。

如果讀取的值超出了可表示範圍unsigned long，則丟擲out_of_range異常。

無效的idx會導致未定義行為。

另見

stoi
將字串轉換為整數 (函式模板)
stol
將字串轉換為長整數 (函式模板)
stoull
將字串轉換為無符號長長整數 (函式模板)
strtoul
將字串轉換為無符號長整型 (函式)