static-string-cpp
Compile-time string manipulation library for modern C++
Integration
This library is header only, you need to include static_string.h
#include <static_string.h>
using namespace snw1;Requirements
C++14 or later is required
How to ...
Create static string from string literal
constexpr auto str = "Hello"_ss; // str == "Hello"
constexpr size_t size = sizeof(str); // size == 6, str ends with '\0'Output static string to standard output stream
constexpr auto str = L"Hello"_ss;
std::wcout << str << std::endl;Convert static string to std::string
constexpr auto str = "Hello"_ss;
std::string str1 = to_string(str);Get static string length and size
constexpr auto str = L"Hello"_ss;
constexpr size_t length = str.length(); // length == 5
constexpr size_t size = str.size(); // size == 5Access static string symbols
constexpr auto str = "Hello"_ss;
constexpr char ch1 = str[1]; // ch1 == 'e'
constexpr char ch4 = str[4]; // ch4 == 'o'
constexpr char ch5 = str[5]; // ch5 == '\0'Iterate through static string
constexpr auto str = L"Hello"_ss;
for (size_t i = str.begin(); i != str.end(); ++i) // forward
std::wcout << str[i];
std::wcout << std::endl; // Hello
for (size_t i = str.rbegin(); i != str.rend(); --i) // backward
std::wcout << str[i];
std::wcout << std::endl; // olleHCalculate static string or string literal hash
constexpr auto str = "Hello"_ss;
constexpr unsigned long long hash1 = str.hash();
constexpr unsigned long long hash2 = static_string_hash("World");
// hash(s) = (s[0] + 1) + (s[1] + 1) * 33 + ... + (s[n - 1] + 1) * 33 ^ (n - 1) + 5381 * 33 ^ n mod 2 ^ 64Compare two static strings or string literals
constexpr auto str1 = L"Hello"_ss;
constexpr auto str2 = L"World"_ss;
static_assert(str1 < str2, "true");
static_assert(str1 >= str2, "false");
static_assert(str1 == L"Hello", "true");
static_assert(L"World" != str2, "false");
static_assert(static_string_compare(L"Hello", L"World") < 0, "true");Convert number to static string
constexpr int num = 12345;
constexpr auto str1 = ITOSS(num); // str1 == "12345";
constexpr auto str2 = ITOSW(num); // str2 == L"12345";Convert static string or string literal to number
constexpr auto str1 = "12345"_ss;
constexpr wchar_t str2[] = L"67890";
constexpr int num1 = SSTOI(str1); // num1 == 12345
constexpr int num2 = SSTOI(str2); // num2 == 67890Concatenate static strings and string literals
constexpr auto hello = "Hello"_ss;
constexpr auto world = "World"_ss;
constexpr auto greeting = hello + ", " + world + "!"; // greeting == "Hello, World!"Concatenate static strings, string literals and numbers
constexpr int apples = 5;
constexpr int oranges = 7;
constexpr auto message = static_wstring::concat(L"I have ", ITOSW(apples),
L" apples and ", ITOSW(oranges), L", so I have ", ITOSW(apples + oranges), L" fruits");
// message = L"I have 5 apples and 7 oranges, so I have 12 fruits" constexpr unsigned long long width = 123456789ULL;
constexpr unsigned long long height = 987654321ULL;
constexpr auto message = static_string::concat("A rectangle with width ", UTOSS(width),
" and height ", UTOSS(height), " has area ", UTOSS(width * height));
// message = "A rectangle with width 123456789 and height 987654321 has area 121932631112635269" constexpr long long revenue = 1'000'000LL;
constexpr long long costs = 1'200'000LL;
constexpr long long profit = revenue - costs;
constexpr auto message = static_wstring::concat(L"The first quarter has ended with net ",
(profit >= 0 ? L"profit" : L"loss "), L" of $", ITOSW(profit < 0 ? -profit : profit));
// message == L"The first quarter has ended with net loss of $200000"Find character in static string or string literal
constexpr auto str = "abracadabra"_ss;
constexpr auto p1 = str.find('d'); // p1 == 6
constexpr auto p2 = str.find('e'); // p2 == static_string_npos
constexpr auto p3 = str.find('a'); // p3 == 0
constexpr auto p4 = str.find('a', 4); // p4 == 5, find from position
constexpr auto p5 = str.find('a', str.begin(), 3); // p5 == 7, find 4th occurrence
constexpr auto p6 = str.rfind('a'); // p6 == 10
constexpr auto p7 = str.rfind('a', 8); // p7 == 7, find from position
constexpr auto p8 = str.rfind('a', str.rbegin(), 3); // p8 == 3, find 4th occurrence
constexpr auto p9 = static_string_find("abracadabra", 'b'); // p9 == 1
constexpr auto p10 = static_string_rfind("abracadabra", 'b'); // p10 == 8Find substring in static string or string literal
constexpr auto str = L"abracadabra"_ss;
constexpr auto p1 = str.find(L"ada"); // p1 == 5
constexpr auto p2 = str.find(L"dbr"); // p2 == static_string_npos
constexpr auto p3 = str.find(L"ab"); // p3 == 0
constexpr auto p4 = str.find(L"ab", 4); // p4 == 7, find from position
constexpr auto p5 = str.find(L"ab", str.begin(), 1); // p5 == 7, find 2nd occurrence
constexpr auto p6 = str.rfind(L"ab"); // p6 == 7
constexpr auto p7 = str.rfind(L"ab", 5); // p7 == 0, find from position
constexpr auto p8 = str.rfind(L"ab", str.rbegin(), 1); // p8 == 0, find 2nd occurrence
constexpr auto p9 = static_string_find(L"abracadabra", L"ab"); // p9 == 0
constexpr auto p10 = static_string_rfind(L"abracadabra", L"ab"); // p10 == 7Check if static string or string literal starts/ends with or contains specified substring
constexpr auto str = "abracadabra"_ss;
static_assert(str.starts_with("abra"), "true");
static_assert(str.starts_with("brac"), "false");
static_assert(str.ends_with("abra"), "true");
static_assert(str.ends_with("dabr"), "false");
static_assert(str.contains("brac"), "true");
static_assert(str.contains("dabr"), "true");
static_assert(str.contains("brbc"), "false");
static_assert(str.contains("drbr"), "false");
static_assert(str.contains('b'), "true");
static_assert(str.contains('e'), "false");
static_assert(static_string_starts_with("abracadabra", "abra"), "true");
static_assert(static_string_ends_with("abracadabra", "abra"), "true");
static_assert(static_string_contains("abracadabra", "brac"), "true");Get number of char occurrences in static string or string literal
constexpr auto str = L"abracadabra"_ss;
constexpr size_t cnt1 = str.count(L'a'); // cnt1 == 5
constexpr size_t cnt2 = static_string_count(L"abracadabra", L'a'); // cnt2 == 5Reverse static substring or string literal
constexpr auto hello = "Hello"_ss;
constexpr auto str1 = hello.reverse(); // str1 == "olleH"
constexpr auto str2 = static_string_reverse("World"); // str2 == "dlroW"Get substring, prefix or suffix of static string or string literal
constexpr auto hello = L"Hello"_ss;
constexpr auto str1 = hello.substring<1, 4>(); // str1 == L"ell";
constexpr auto str2 = hello.prefix<4>(); // str2 == L"Hell";
constexpr auto str3 = hello.suffix<1>(); // str3 == L"ello";
constexpr auto str4 = static_string_substring<1, 4>(L"World"); // str4 == L"orl";
constexpr auto str5 = static_string_prefix<4>(L"World"); // str5 == L"Worl";
constexpr auto str6 = static_string_suffix<1>(L"World"); // str6 == L"orld";Split static string or string literal
constexpr auto a = "abracadabra"_ss;
constexpr auto p1 = a.split<5>(); // p1 == {"abrac", "dabra"}
constexpr auto p2 = a.split<a.find('d')>(); // p2 == {"abraca", "abra"}
constexpr auto p3 = a.split<a.find('a', a.begin(), 1)>(); // p3 == {"abr", "cadabra"}
constexpr auto p4 = a.split<a.rfind('a', a.rbegin(), 1)>(); // p4 == {"abracad", "bra"}
constexpr auto p5 = static_string_split<5>("abracadabra"); // p5 == {"abrac", "dabra"}Split static string into substrings and numbers
constexpr auto url = L"http://www.server.com:8080"_ss;
constexpr auto p = url.find(L"://");
constexpr auto protocol = url.prefix<p>(); // protocol == L"http"
constexpr auto sockaddr = url.suffix<p + 3>();
constexpr auto hp = sockaddr.split<sockaddr.find(L':')>();
constexpr auto host = hp.first; // host == L"www.server.com"
constexpr int port = SSTOI(hp.second); // port == 8080License
The library is licensed under the MIT License
Copyright (c) 2017-2018 Andrew Sheetov <[email protected]>
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.