Namespaces
Variants
Views
Actions

Difference between revisions of "cpp/header/charconv"

From cppreference.com
< cpp‎ | header
(Applied P2497R0 (Testing for success or failure of <charconv> functions).)
m (Synopsis)
Line 62: Line 62:
 
}}
 
}}
  
{{langlinks|es|ja|zh}}
+
{{langlinks|es|ja|ru|zh}}

Revision as of 22:21, 5 September 2023

 
 
Standard library headers
General utilities
<any> (C++17)
<bitset>
<bit> (C++20)
<charconv> (C++17)
<expected> (C++23)
<format> (C++20)
<functional>
<optional> (C++17)
<tuple> (C++11)
<typeindex> (C++11)
<utility>
<variant> (C++17)
Containers
<array> (C++11)
<deque>
<flat_map> (C++23)
<flat_set> (C++23)
<forward_list> (C++11)
<inplace_vector> (C++26)   
<list>
<map>
<mdspan> (C++23)
<queue>
<set>
<span> (C++20)
<stack>
<unordered_map> (C++11)
<unordered_set> (C++11)
<vector>
Iterators
<iterator>
Ranges
<generator> (C++23)
<ranges> (C++20)
 

This header is part of the strings library.

Classes

specifies formatting for std::to_chars and std::from_chars
(enum) [edit]
the return type of std::from_chars
(class) [edit]
the return type of std::to_chars
(class) [edit]

Functions

converts a character sequence to an integer or floating-point value
(function) [edit]
(C++17)
converts an integer or floating-point value to a character sequence
(function) [edit]

Synopsis

namespace std {
  // floating-point format for primitive numerical conversion
  enum class chars_format {
    scientific = /* unspecified */,
    fixed = /* unspecified */,
    hex = /* unspecified */,
    general = fixed | scientific
  };
 
 
  // primitive numerical output conversion
  struct to_chars_result {
    char* ptr;
    errc ec;
    friend bool operator==(const to_chars_result&, const to_chars_result&) = default;
    constexpr explicit operator bool() const noexcept { return ec == errc{}; }
  };
 
  constexpr
  to_chars_result to_chars(char* first, char* last,
                           /* integer-type */ value, int base = 10);
  to_chars_result to_chars(char* first, char* last, bool value, int base = 10) = delete;
  to_chars_result to_chars(char* first, char* last, /* floating-point-type */ value);
  to_chars_result to_chars(char* first, char* last, /* floating-point-type */ value,
                           chars_format fmt);
  to_chars_result to_chars(char* first, char* last, /* floating-point-type */ value,
                           chars_format fmt, int precision);
 
  // primitive numerical input conversion
  struct from_chars_result {
    const char* ptr;
    errc ec;
    friend bool operator==(const from_chars_result&, const from_chars_result&) = default;
    constexpr explicit operator bool() const noexcept { return ec == errc{}; }
  };
 
  constexpr
  from_chars_result from_chars(const char* first, const char* last,
                               /* integer-type */& value, int base = 10);
  from_chars_result from_chars(const char* first, const char* last,
                               /* floating-point-type */& value,
                               chars_format fmt = chars_format::general);
}