GeezerVison is showing cpprefjp.github.io — std::stol - cpprefjp C++日本語リファレンス
最終更新日時:
2026年10月03日 22時31分04秒 (JST)
Akira Takahashi
が更新
function
<string>
std:: stol (C++11)
概要
文字列strを数値として読み取って、long型の値に変換する。
効果
パラメータstrがstring型であればstd::strtol(str.c_str(), &end, base)、wstring型であればstd::wcstol(str.c_str(), &end, base)を呼び出して、その戻り値を返す。
パラメータidxが非nullptrの場合、変換に使用されなかった要素のインデックス（end - str.c_str()）が格納される。
パラメータbaseは、整数文字列strの基数を表す。デフォルトでは10進数として文字列を整数に変換する。基数は2から36(36含む)進数を指定できる。基数を0とした場合は、文字列のプレフィックスから基数が自動的に選択される。自動的な選択のルールは、以下のようになる：
先頭が0：8進数
先頭が0xもしくは0X：16進数
戻り値
変換して得られた数値が返される。
例外
備考
errnoの扱い
Visual C++ 11やGCC (libstdc++) 4.8.2では、この関数を呼び出すとerrnoの値が変更される。
Clang (libc++) 3.3では、この関数の呼び出し前後でerrnoの値は変化しない。
グローバルロケールの影響
この関数は、setlocale()
strtol()関数での文字列先頭の空白を読み飛ばす処理に、<cctype>のisspace()関数が使用されるためである。
例
#include <iostream>
#include <string>
int main ()
{
// 10進法での変換
{
std::cout << "---- base = 10" << std::endl ;
long x = std::stol ( "10" ); // std::stol ("10", nullptr, 10);
std::cout << x << std::endl ;
long xw = std::stol ( L "11" ); // std::stol (L"11", nullptr, 10);
std::cout << xw << std::endl ;
}
// 2進法での変換
{
std::cout << "---- base = 2" << std::endl ;
long x = std::stol ( "1001" , nullptr , 2 );
std::cout << x << std::endl ;
long xw = std::stol ( L "01001" , nullptr , 2 ); // 先頭に0が付いていてもよい
std::cout << xw << std::endl ;
}
// 8進法での変換
{
std::cout << "---- base = 8" << std::endl ;
long x = std::stol ( "10" , nullptr , 8 );
std::cout << x << std::endl ;
long xw = std::stol ( L "10" , nullptr , 8 );
std::cout << xw << std::endl ;
}
// 16進法での変換
{
std::cout << "---- base = 16" << std::endl ;
long x = std::stol ( "10" , nullptr , 16 );
std::cout << x << std::endl ;
long xw = std::stol ( L "11" , nullptr , 16 );
std::cout << xw << std::endl ;
}
// 16進法での変換（プレフィックス付き）
{
long x = std::stol ( "0x20" , nullptr , 16 );
std::cout << x << std::endl ;
long xw = std::stol ( L "0x21" , nullptr , 16 );
std::cout << xw << std::endl ;
}
// base = 0による10進法・8進法・16進法の自動判別
{
std::cout << "---- base = 0" << std::endl ;
std::cout << std::stol ( "100" , nullptr , 0 ) << std::endl ;
std::cout << std::stol ( "0100" , nullptr , 0 ) << std::endl ;
std::cout << std::stol ( "0x100" , nullptr , 0 ) << std::endl ;
std::cout << std::stol ( L "100" , nullptr , 0 ) << std::endl ;
std::cout << std::stol ( L "0100" , nullptr , 0 ) << std::endl ;
std::cout << std::stol ( L "0x100" , nullptr , 0 ) << std::endl ;
}
// 2番目の仮引数の使用例
{
std::cout << "---- use of idx parameter" << std::endl ;
std::string s = "30%" ;
std::size_t i ;
long x = std::stol ( s , & i );
std::cout << x << ' ' << s [ i ] << std::endl ;
std::wstring ws = L "31%" ;
std::size_t wi ;
long xw = std::stol ( ws , & wi );
std::cout << xw << ' ' << wi << std::endl ;
}
// 文字列先頭に空白がある場合
{
std::cout << "---- space character before number" << std::endl ;
std::cout << std::stol ( " -1" ) << std::endl ;
std::cout << std::stol ( L " -2" ) << std::endl ;
}
}
出力
---- base = 10
10
11
---- base = 2
9
9
---- base = 8
8
8
---- base = 16
16
17
32
33
---- base = 0
100
64
256
100
64
256
---- use of idx parameter
30 %
31 2
---- space character before number
-1
-2
実装例
long stol ( const std::string & str , std::size_t * idx = nullptr , long base = 10 ) {
const char * p = str.c_str() ;
char * end ;
errno = 0 ;
long x = std :: strtol ( p , & end , base );
if ( p == end ) {
throw std :: invalid_argument ( "stol" );
}
if ( errno == ERANGE ) {
throw std :: out_of_range ( "stol" );
}
if ( idx != nullptr ) {
* idx = static_cast < std::size_t > ( end - p );
}
return x ;
}
long stol ( const std::wstring & str , std::size_t * idx = nullptr , long base = 10 ) {
const wchar_t * p = str.c_str() ;
wchar_t * end ;
errno = 0 ;
long x = std :: wcstol ( p , & end , base );
if ( p == end ) {
throw std :: invalid_argument ( "stol" );
}
if ( errno == ERANGE ) {
throw std :: out_of_range ( "stol" );
}
if ( idx != nullptr ) {
* idx = static_cast < std::size_t > ( end - p );
}
return x ;
}
バージョン
言語
処理系
関連リンク
C標準ライブラリに由来する関数
atol stolはatol std::stringおよびstd::wstringに対応させたものと見なせる。strtol wcstol stolはstrtolおよびwcstolをそれぞれstd::stringとstd::wstringに対応させたものと見なせる。
ファミリー
stoi intとなったもの。(stol: この関数自身)
stoll long longとなったもの。stoul unsigned longとなったもの。stoull unsigned long longとなったもの。stof floatとなったもの。stod doubleとなったもの。stold long doubleとなったもの。
ロケール依存しない高速な変換関数
参照