[#bsl-stold-04]
= xref:bsl.adoc[bsl]::stold
:relfileprefix: ../
:mrdocs:

`stold` overloads

== Synopses

Declared in `<bslstl_string.h>`

Parses `str` interpreting its contents as a floating point number. In C++11 if the number in `str` is prefixed with `0x` or `0X` the string will be interpreted as a hex number. If there is no leading 0x or 0X the string will be interpreted as a decimal number. Optionally specify `pos` whose value is set to the position of the next character after the numerical value. The function ignores leading white space characters and interprets as many characters possible to form a valid floating point number. If no conversion could be performed, then an `invalid_argument` exception is thrown. If the value read is out of range of the return type, then an `out_of_range` exception is thrown.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
long double
xref:bsl/stold-02.adoc[stold](
    xref:bsl/string.adoc[string] const& str,
    std::size_t* pos = 0);
----

[.small]#xref:bsl/stold-02.adoc[_» more..._]#

Same as `stold` for `wstring`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
long double
xref:bsl/stold-06.adoc[stold](
    xref:bsl/wstring.adoc[wstring] const& str,
    std::size_t* pos = 0);
----

[.small]#xref:bsl/stold-06.adoc[_» more..._]#


[.small]#Created with https://www.mrdocs.com[MrDocs]#