]> code.bitgloo.com Git - clyne/constexpr-to-string.git/commitdiff
Update README.md
authorclyne <clyne@bitgloo.com>
Fri, 26 Jun 2020 15:13:25 +0000 (11:13 -0400)
committerGitHub <noreply@github.com>
Fri, 26 Jun 2020 15:13:25 +0000 (11:13 -0400)
README.md

index 1bbc479de595bc43cac5eb7ee1513da2145b6c76..9c1ebcf2ee540b0b1e5f713cffbc23c1d89679c2 100644 (file)
--- a/README.md
+++ b/README.md
@@ -1,2 +1,25 @@
 # constexpr-to-string
-C++17 code to convert integers to strings at compile-time
+
+**Features:**
+
+* Convert any integral type to a string at compile-time
+* String can be in binary, hexadecimal, or any base in-between
+* No external dependencies, only includes `type_traits` for type-checking
+* Works best in C++20 GCC or C++17/20 Clang
+
+**How to use:**
+
+This single header file provides a `to_string` utility, which may be used as below:
+
+```cpp
+const char *number = to_string<2147483648999954564, 16>; // produces "1DCD65003B9A1884"
+puts(number);
+puts(to_string<-42>); // produces "-42"
+puts(to_string<30, 2>); // produces "11110"
+```
+
+With `to_string`, all that will be found in program disassembly are the resulting string literals, as if you wrote the strings yourself.
+
+**Known issues:**
+
+* With C++17 GCC, `to_string` must be used to initialize variables; otherwise, the integer-string conversion is done at run-time.