std::stoi, std::stol, std::stoll

From Cppreference

Jump to: navigation, search
Defined in header <string>

int       stoi( const std::string& str, size_t *pos = 0, int base = 10 );
(1) (C++11 feature)
long      stol( const std::string& str, size_t *pos = 0, int base = 10 );
(2) (C++11 feature)
long long stoll( const std::string& str, size_t *pos = 0, int base = 10 );
(3) (C++11 feature)

Interprets a signed integer value in the string str.

Function discards any whitespace characters until first non-whitespace character is found. Then it takes as many characters as possible to form a valid base-n (where n=base) integer number representation and converts them to an integer value. The valid integer value consists of the following parts:

The set of valid digits for base-2 integer is 01, for base-3 integer is 012, and so on. For bases larger than 10, valid digits include alphabetic characters, starting from Aa for base-11 integer, to Zz for base-36 integer. The case of the characters is ignored.

The index of the first unconverted character is stored in pos. If NULL is passed as pos, it is ignored.

Contents

[edit] Parameters

str - the string to convert
pos - address of an integer to store the index of the first unconverted character
base - the number base

[edit] Return value

The string converted to the specified signed integer type.

[edit] Exceptions

std::invalid_argument if no conversion could be performed

std::out_of_range if the converted value would fall out of the range of the result type.

[edit] Example

std::string test = "45";
int myint = stoi(test);

[edit] See also

stoul
stoull
(C++11)
(C++11)
converts a string to an unsigned integer
(function)
stof
stod
stold
(C++11)
(C++11)
(C++11)
converts a string to an floating point value
(function)