<charconv>

Quickly convert a character sequence to an integer or floating-point value, and the other way around. One way to use this library is to write and roundtrip floating-point values in JSON and text files.

The conversion functions are tuned for performance, and also support shortest-round-trip behavior. Shortest-round-trip behavior means when a number is converted to chars, only enough precision is written out to enable recovering the original number when converting those chars back to a floating-point. No other CRT or STL function provides this capability.

Some of the benefits of using the <charconv> library are:

• The sequence of chars representing a numeric value doesn't need to be null-terminated. Likewise, when a number is converted to chars, the result isn't null-terminated.
• Conversion functions don't allocate memory. You own the buffer in all cases.
• Conversion functions don't throw. They return a structure that contains error information.
• Conversions aren't runtime rounding-mode sensitive.
• Conversions aren't locale aware. They always print and parse decimal points as '.' never as ',' for locales that use commas.

Requirements

Header: <charconv>

Namespace: std

/std:c++17 or later is required.

Members

Types

Type	Description
chars_format	Specifies formatting type such as scientific, hex, and so on.
from_chars_result	Holds the result of a from_chars conversion.
to_chars_result	Holds the result of a to_chars conversion.

Functions

Function	Description
from_chars	Convert chars to an integer, float, or double.
to_chars	Convert an integer, float, or double to chars.

See also

Header Files Reference