std::stof, std::stod, std::stold — cppreference.com

Материал из cppreference.com

Определено в заголовочном файле `<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, если преобразованное значение будет выходить за границы диапазона значений типа результата

См. также

Категории: