std::stof, std::stod, std::stold

float       stof ( const std::string& str, std::size_t* pos = nullptr );

float       stof ( const std::wstring& str, std::size_t* pos = nullptr );

double      stod ( const std::string& str, std::size_t* pos = nullptr );

double      stod ( const std::wstring& str, std::size_t* pos = nullptr );

long double stold( const std::string& str, std::size_t* pos = nullptr );

long double stold( const std::wstring& str, std::size_t* pos = nullptr );

Интерпретирует значение с плавающей запятой в строке str.

Пусть ptr - это внутренний (для функций преобразования) указатель типа char* (1,3,5) или wchar_t* (2,4,6), соответственно.

Функция игнорирует любые символы пробелов (как определено std::isspace) до первого символа, не являющегося пробелом. Затем она берёт как можно больше символов для формирования допустимого представления с плавающей запятой и преобразует их в значение с плавающей запятой. Допустимое значение с плавающей запятой может быть одним из следующих:

• десятичное представление с плавающей запятой. Оно состоит из следующих частей:
• (необязательно) знак плюс или минус
• непустая последовательность десятичных цифр, необязательно содержащая десятичную точку (как определено текущим C locale) (определяет мантиссу)
• (необязательно) e или E, за которыми следует необязательный знак минус или плюс и непустая последовательность десятичных цифр (определяет экспоненту по основанию 10)
• шестнадцатеричное представление с плавающей запятой. Оно состоит из следующих частей:
• (необязательно) знак плюс или минус
• 0x или 0X
• непустая последовательность шестнадцатеричных цифр, необязательно содержащая десятичную точку (как определено текущим C locale) (определяет мантиссу)
• (необязательно) p или P, за которыми следует необязательный знак минус или плюс и непустая последовательность десятичных цифр (определяет экспоненту по основанию 2)
• бесконечность. Она состоит из следующих частей:
• (необязательно) знак плюс или минус
• INF или INFINITY (регистр игнорируется)
• не число. Она состоит из следующих частей:
• (необязательно) знак плюс или минус
• NAN или NAN(последовательность_символов) (регистр части NAN игнорируется). последовательность_символов может содержать только цифры, латинские буквы и символы подчёркивания. Результатом является тихий NaN (Not a Number) с плавающей запятой.
• любое другое представление, которое может быть принято текущим C locale

Если pos не является нулевым указателем, то ptr получит адрес первого необработанного символа в str.c_str(), и индекс этого символа будет рассчитан и сохранён в *pos, показывая количество обработанных символов во время преобразования.

Параметры

Возвращаемое значение

Строка, преобразованная в указанный тип с плавающей запятой.

Исключение

std::invalid_argument если преобразование не выполнено.

std::out_of_range если преобразованное значение выйдет за пределы диапазона результата, или если подлежащая функция (std::strtof, std::strtod или std::strtold) установит errno в ERANGE.

Пример

Отчеты об ошибках

Следующие отчеты об ошибках, изменяющие поведение, были применены ретроактивно к ранее опубликованным стандартам C++.

См. также