Namespaces
Variants
Views
Actions

Difference between revisions of "cpp/header/charconv"

From cppreference.com
< cpp‎ | header
(rvv)
(move synopsis to template)
 
(9 intermediate revisions by 5 users not shown)
Line 1: Line 1:
−
{{cpp/header/title|charconv}}
+
{{cpp/header/title|charconv|notes={{mark c++17}}}}
 
{{cpp/header/navbar}}
 
{{cpp/header/navbar}}
  
−
===Classes===
+
This header is part of the [[cpp/string|strings]] library.
 +
 
 
{{dsc begin}}
 
{{dsc begin}}
−
{{dsc inc | cpp/utility/dsc chars_format}}
+
{{dsc h1|Classes}}
−
{{dsc end}}
+
{{dsc inc|cpp/utility/dsc chars_format}}
 +
{{dsc inc|cpp/utility/dsc from_chars_result}}
 +
{{dsc inc|cpp/utility/dsc to_chars_result}}
  
−
===Functions===
+
{{dsc h1|Functions}}
−
 
+
{{dsc inc|cpp/utility/dsc from_chars}}
−
{{dsc begin}}
+
{{dsc inc|cpp/utility/dsc to_chars}}
−
{{dsc inc | cpp/utility/dsc from_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
+
−
    };
+
−
    // primitive numerical output conversion
+
−
    struct to_chars_result {
+
−
        char* ptr;
+
−
        errc ec;
+
−
    };
+
−
    to_chars_result to_chars(char* first, char* last,
+
−
                            /*see description*/ value, int base = 10);
+
−
    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;
+
−
    };
+
−
    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|ja|zh}}
+
{{langlinks|es|ja|ru|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"