Namespaces
Variants
Views
Actions

Difference between revisions of "cpp/header/charconv"

From cppreference.com
< cpp‎ | header
m (+C++17)
(move synopsis to template)
 
(5 intermediate revisions by 3 users not shown)
Line 5: Line 5:
  
 
{{dsc begin}}
 
{{dsc begin}}
−
{{dsc h1 | Classes}}
+
{{dsc h1|Classes}}
−
{{dsc inc | cpp/utility/dsc chars_format}}
+
{{dsc inc|cpp/utility/dsc chars_format}}
 +
{{dsc inc|cpp/utility/dsc from_chars_result}}
 +
{{dsc inc|cpp/utility/dsc to_chars_result}}
  
−
{{dsc h1 | Functions}}
+
{{dsc h1|Functions}}
−
{{dsc inc | cpp/utility/dsc from_chars}}
+
{{dsc inc|cpp/utility/dsc from_chars}}
−
{{dsc inc | cpp/utility/dsc to_chars}}
+
{{dsc inc|cpp/utility/dsc to_chars}}
 
{{dsc end}}
 
{{dsc end}}
  
 
===Synopsis===
 
===Synopsis===
−
{{source|1=
+
{{cpp/synopsis/charconv}}
−
namespace std {
+
−
  // floating-point format for primitive numerical conversion
+
−
  enum class chars_format {
+
−
    scientific = /* unspecified */,
+
−
    fixed = /* unspecified */,
+
−
    hex = /* unspecified */,
+
−
    general = fixed {{!}} scientific
+
−
  };
+
  
−
 
+
{{langlinks|es|ja|ru|zh}}
−
  // primitive numerical output conversion
+
−
  struct to_chars_result {
+
−
    char* ptr;
+
−
    errc ec;
+
−
    friend bool operator==(const to_chars_result&, const to_chars_result&) = default;
+
−
  };
+
−
 
+
−
  to_chars_result to_chars(char* first, char* last,
+
−
                          /* see description */ 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, float value);
+
−
  to_chars_result to_chars(char* first, char* last, double value);
+
−
  to_chars_result to_chars(char* first, char* last, long double value);
+
−
 
+
−
  to_chars_result to_chars(char* first, char* last, float value, chars_format fmt);
+
−
  to_chars_result to_chars(char* first, char* last, double value, chars_format fmt);
+
−
  to_chars_result to_chars(char* first, char* last, long double value, chars_format fmt);
+
−
 
+
−
  to_chars_result to_chars(char* first, char* last, float value,
+
−
                          chars_format fmt, int precision);
+
−
  to_chars_result to_chars(char* first, char* last, double value,
+
−
                          chars_format fmt, int precision);
+
−
  to_chars_result to_chars(char* first, char* last, long double 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;
+
−
  };
+
−
 
+
−
  from_chars_result from_chars(const char* first, const char* last,
+
−
                              /* see description */& value, int base = 10);
+
−
 
+
−
  from_chars_result from_chars(const char* first, const char* last, float& value,
+
−
                              chars_format fmt = chars_format::general);
+
−
  from_chars_result from_chars(const char* first, const char* last, double& value,
+
−
                              chars_format fmt = chars_format::general);
+
−
  from_chars_result from_chars(const char* first, const char* last, long double& value,
+
−
                              chars_format fmt = chars_format::general);
+
−
}
+
−
}}
+
−
 
+
−
{{langlinks|es|ja|zh}}
+

Latest revision as of 07:08, 27 November 2023

 
C++
 
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

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

Functions

(C++17)
 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]

[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 { // freestanding
    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, // freestanding
                           /* integer-type */ value, int base = 10);
  to_chars_result to_chars(char* first, char* last, // freestanding
                           bool value, int base = 10) = delete;
  to_chars_result to_chars(char* first, char* last, // freestanding-deleted
                           /* floating-point-type */ value);
  to_chars_result to_chars(char* first, char* last, // freestanding-deleted
                           /* floating-point-type */ value, chars_format fmt);
  to_chars_result to_chars(char* first, char* last, // freestanding-deleted
                           /* floating-point-type */ value,
                           chars_format fmt, int precision);
 
  // primitive numerical input conversion
  struct from_chars_result { // freestanding
    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, // freestanding
                               const char* last, /* integer-type */& value,
                               int base = 10);
  from_chars_result from_chars(const char* first, // freestanding-deleted
                               const char* last, /* floating-point-type */& value,
                               chars_format fmt = chars_format::general);
}
Retrieved from "https://en.cppreference.com/mwiki/index.php?title=cpp/header/charconv&oldid=163965"