stoi
문자 시퀀스를 정수로 변환합니다.
int stoi( const string& _Str, size_t *_Idx = 0, int _Base = 10 ); int stoi( const wstring& _Str, size_t *_Idx = 0, int _Base = 10 );
반환 값
정수 값입니다.
매개 변수
매개 변수 |
설명 |
|---|---|
_Str |
변환할 문자 시퀀스입니다. |
_Idx |
반환 시 변환되지 않은 첫 번째 문자의 인덱스를 포함합니다. |
_Base |
사용할 기수입니다. |
설명
stoi 함수는 _Str의 문자 시퀀스를 int 형식 값으로 변환하고 값을 반환합니다. 예를 들어 문자 시퀀스 "10" 전달 시 stoi에서 반환하는 값은 정수 10입니다.
stoi는 strtol(_Str.c_str(), _Eptr, _Base) 방식으로 호출하는 경우 싱글바이트 문자에 대해 strtol 함수와 비슷하게 동작하고, wcstol(Str.c_str(), _Eptr, _Base) 방식으로 호출하는 경우에는 와이드 문자에 대해 wcstol 함수와 비슷하게 동작합니다. 여기서 _Eptr은 함수 내부의 개체입니다. 자세한 내용은 strtol, wcstol, _strtol_l, _wcstol_l을 참조하십시오.
_Str.c_str() == *_Eptr,인 경우 stoi는 invalid_argument 형식의 개체를 throw합니다. 이러한 호출에서 errno를 설정하거나 반환되는 값을int 형식의 개체로 나타낼 수 없는 경우에는 out_of_range 형식의 개체가 throw됩니다. 반면 _Idx가 null 포인터가 아닌 경우 함수는 *_Idx에 *_Eptr - __Str.c_str()을 저장합니다.
요구 사항
헤더: <string>
네임스페이스: std