std::stof, std::stod, std::stold
| Определено в заголовочном файле <string>
|
||
| float stof( const std::string& str, size_t *pos = 0 ); |
(1) | (начиная с C++11) |
| double stod( const std::string& str, size_t *pos = 0 ); |
(2) | (начиная с C++11) |
| long double stold( const std::string& str, size_t *pos = 0 ); |
(3) | (начиная с C++11) |
Извлекает число с плавающей точкой из строки str.
Функция отбрасывает пробельные символы (определяемые с помощью std::isspace), пока не будет найден первый непробельный символ. Затем требуется как можно больше символов для формирования допустимого представления с плавающей запятой, и они преобразуются в значение с плавающей запятой. Допустимое значение с плавающей запятой может быть одним из следующих:
- десятичное выражение с плавающей запятой. Оно состоит из следующих частей:
- (необязательно) знак плюс или минус
- непустая последовательность десятичных цифр, необязательно содержащая символ десятичной точки (как определено текущей локалью C) (определяет мантиссу)
- (необязательно) символ
eилиE, за которым следует необязательный знак минус или плюс и непустая последовательность десятичных цифр (определяет экспоненту по основанию 10)
- шестнадцатеричное выражение с плавающей запятой. Оно состоит из следующих частей:
- (необязательно) знак плюс или минус
-
0xили0X - непустая последовательность шестнадцатеричных цифр, необязательно содержащая символ десятичной точки (как определено текущей локалью C) (определяет мантиссу)
- (необязательно)
pилиP, за которыми следует необязательный знак минус или плюс и непустая последовательность десятичных цифр (определяет экспоненту по основанию 2)
- выражение бесконечности. Оно состоит из следующих частей:
- (необязательно) знак плюс или минус
-
INFилиINFINITYбез учёта регистра
- не числовое выражение. Оно состоит из следующих частей:
- (необязательно) знак плюс или минус
-
NANилиNAN(последовательность символов)без учёта регистра частиNAN. последовательность символов может содержать только цифры, латинские буквы и знаки подчёркивания. Результатом является тихое значение NaN с плавающей запятой.
- любое другое выражение, которое может быть принято текущей установленной локалью C
Индекс первого непреобразованного символа сохраняется в pos. Если в качестве pos передан NULL, параметр игнорируется.
Содержание |
[править] Параметры
| str | — | строка для преобразования |
| pos | — | адрес переменной целочисленного типа для сохранения в ней индекса первого непреобразованного символа |
[править] Возвращаемое значение
Строка, преобразованная в число с плавающей точкой указанного типа.
[править] Исключения
std::invalid_argument, если преобразование не может быть выполнено
std::out_of_range, если преобразованное значение будет выходить за границы диапазона значений типа результата
[править] См. также
| (C++11)(C++11)(C++11) |
преобразует строку в целое число со знаком (функция) |
| (C++11)(C++11) |
преобразует строку в целое число без знака (функция) |
