-
Notifications
You must be signed in to change notification settings - Fork 17
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge remote-tracking branch 'origin/develop' into more_int_tests
- Loading branch information
Showing
72 changed files
with
10,575 additions
and
982 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,5 +1,111 @@ | ||
| # charconv | ||
| C++11 compatible charconv | ||
| # CharConv | ||
| This library is a C++11 compatible implementation of `<charconv>`. The full documentation can be found here: https://develop.charconv.cpp.al | ||
|
|
||
| # Notice | ||
| This library is not an official boost library, and is under active development. | ||
|
|
||
| # Synopsis | ||
|
|
||
| Charconv is a collection of parsing functions that are locale-independent, non-allocating, and non-throwing. | ||
|
|
||
| ```` | ||
| enum class chars_format : unsigned | ||
| { | ||
| scientific = 1 << 0, | ||
| fixed = 1 << 1, | ||
| hex = 1 << 2, | ||
| general = fixed | scientific | ||
| }; | ||
| struct from_chars_result | ||
| { | ||
| const char* ptr; | ||
| std::errc ec; | ||
| friend constexpr bool operator==(const from_chars_result& lhs, const from_chars_result& rhs) noexcept | ||
| friend constexpr bool operator!=(const from_chars_result& lhs, const from_chars_result& rhs) noexcept | ||
| } | ||
| template <typename Integral> | ||
| BOOST_CXX14_CONSTEXPR from_chars_result from_chars(const char* first, const char* last, Integral& value, int base = 10) noexcept; | ||
| BOOST_CXX14_CONSTEXPR from_chars_result from_chars<bool>(const char* first, const char* last, bool& value, int base) = delete; | ||
| template <typename Real> | ||
| from_chars_result from_chars(const char* first, const char* last, Real& value, chars_format fmt = chars_format::general) noexcept; | ||
| struct to_chars_result | ||
| { | ||
| char* ptr; | ||
| std::errc ec; | ||
| friend constexpr bool operator==(const to_chars_result& lhs, const to_chars_result& rhs) noexcept; | ||
| friend constexpr bool operator!=(const to_chars_result& lhs, const to_chars_result& rhs) noexcept; | ||
| }; | ||
| template <typename Integral> | ||
| BOOST_CHARCONV_CONSTEXPR to_chars_result to_chars(char* first, char* last, Integral value, int base = 10) noexcept; | ||
| template <typename Integral> | ||
| BOOST_CHARCONV_CONSTEXPR to_chars_result to_chars<bool>(char* first, char* last, Integral value, int base) noexcept = delete; | ||
| template <typename Real> | ||
| to_chars_result to_chars(char* first, char* last, Real value, chars_format fmt = chars_format::general, int precision) noexcept; | ||
| ```` | ||
|
|
||
| ## Notes | ||
| - `BOOST_CXX14_CONSTEXPR` is defined as `constexpr` when compiling with C++14 or newer. | ||
|
|
||
| - `BOOST_CHARCONV_CONSTEXPR` is defined as `constexpr` when compiling with C++14 or newer, and the compiler has `__builtin_is_constant_evaluated` | ||
|
|
||
| # Examples | ||
|
|
||
| ## `from_chars` | ||
|
|
||
| ```` | ||
| const char* buffer = "42"; | ||
| int v = 0; | ||
| from_chars_result r = boost::charconv::from_chars(buffer, buffer + std::strlen(buffer), v); | ||
| assert(r.ec == std::errc()); | ||
| assert(v == 42); | ||
| const char* buffer = "1.2345" | ||
| double v = 0; | ||
| auto r = boost::charconv::from_chars(buffer, buffer + std::strlen(buffer), v); | ||
| assert(r.ec == std::errc()); | ||
| assert(v == 1.2345); | ||
| const char* buffer = "2a"; | ||
| unsigned v = 0; | ||
| auto r = boost::charconv::from_chars(buffer, buffer + std::strlen(buffer), v, 16); | ||
| assert(r.ec == std::errc()); | ||
| assert(v == 42); | ||
| const char* buffer = "1.3a2bp-10"; | ||
| double v = 0; | ||
| auto r = boost::charconv::from_chars(buffer, buffer + std::strlen(buffer), v, boost::charconv::chars_format::hex); | ||
| assert(r.ec == std::errc()); | ||
| assert(v == 8.0427e-18); | ||
| ```` | ||
| ## `to_chars` | ||
|
|
||
| ```` | ||
| char buffer[64] {}; | ||
| int v = 42; | ||
| to_chars_result r = boost::charconv::to_chars(buffer, buffer + sizeof(buffer) - 1, v); | ||
| assert(r.ec == std::errc()); | ||
| assert(!strcmp(buffer, "42")); // strcmp returns 0 on match | ||
| char buffer[64] {}; | ||
| double v = 1e300; | ||
| to_chars_result r = boost::charconv::to_chars(buffer, buffer + sizeof(buffer) - 1, v); | ||
| assert(r.ec == std::errc()); | ||
| assert(!strcmp(buffer, "1e+300")); | ||
| char buffer[64] {}; | ||
| int v = 42; | ||
| to_chars_result r = boost::charconv::to_chars(buffer, buffer + sizeof(buffer) - 1, v, 16); | ||
| assert(r.ec == std::errc()); | ||
| assert(!strcmp(buffer, "2a")); // strcmp returns 0 on match | ||
| ```` |
Oops, something went wrong.