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 локалью) (определяет мантиссу)
• (необязательно) e или E с последующим необязательным знаком минус или плюс и непустой последовательностью десятичных цифр (определяет показатель степени по основанию 10)

• шестнадцатеричное выражение с плавающей запятой. Оно состоит из следующих частей:

• (необязательно) знак плюс или минус
• 0x или 0X
• непустая последовательность шестнадцатеричных цифр, возможно содержащая символ десятичной точки (определяемый текущей C локалью) (определяет мантиссу)
• (необязательно) p или P с последующим необязательным знаком минус или плюс и непустой последовательностью десятичных цифр (определяет показатель степени по основанию 2)

• выражение бесконечности. Оно состоит из следующих частей:

• (необязательно) знак плюс или минус
• INF или INFINITY без учёта регистра

• выражение не-числа. Оно состоит из следующих частей:

• (необязательно) знак плюс или минус
• NAN или NAN(char_sequence ) без учёта регистра части NAN. char_sequence может содержать только цифры, латинские буквы и символы подчёркивания. Результатом является тихое значение NaN с плавающей запятой.

• любое другое выражение, которое может быть принято текущей установленной C локалью.

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

Параметры

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

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

Исключения

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

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

Пример

Отчёты о дефектах

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

Смотрите также