libnick 2025.3.5
A cross-platform base for native Nickvision applications.
Loading...
Searching...
No Matches
stringhelpers.h
Go to the documentation of this file.
1
22
23#ifndef STRINGHELPERS_H
24#define STRINGHELPERS_H
25
26#include <cstddef>
27#include <cstdint>
28#include <string>
29#include <type_traits>
30#include <vector>
31
33{
34 template<typename T>
35 concept StringImplicitlyConstructible = std::is_constructible_v<T, std::string> && std::is_convertible_v<std::string, T>;
36
42 std::vector<std::byte> decode(const std::string& base64);
48 std::string encode(const std::vector<std::byte>& bytes);
54 bool isValidUrl(const std::string& s);
62 std::string join(const std::vector<std::string>& values, const std::string& separator, bool separateLast = false);
68 std::string lower(std::string s);
73 std::string newUuid();
79 std::string newGuid();
86 std::string normalizeForFilename(const std::string& s, bool windowsOnly = false);
94 std::string replace(std::string s, const std::string& toReplace, const std::string& replace);
102 std::string replace(std::string s, char toReplace, char replace);
108 std::vector<std::string> splitArgs(std::string s);
114 std::string str(const std::wstring& s);
124 unsigned int stoui(const std::string& s, size_t* idx = nullptr, int base = 10);
130 std::string trim(const std::string& s);
137 std::string trim(const std::string& s, char delimiter);
143 std::string upper(std::string s);
149 std::wstring wstr(const std::string& s);
158 template<StringImplicitlyConstructible T = std::string>
159 std::vector<T> split(const std::string& s, const std::string& delimiter, bool includeEmpty = true)
160 {
161 std::vector<T> splits;
162 size_t last{ 0 };
163 size_t next{ 0 };
164 while((next = s.find(delimiter, last)) != std::string::npos)
165 {
166 std::string token{ s.substr(last, next - last) };
167 if(includeEmpty || !trim(token).empty())
168 {
169 splits.push_back(token);
170 }
171 last = next + delimiter.length();
172
173 }
174 std::string finalToken{ s.substr(last) };
175 if(includeEmpty || !trim(finalToken).empty())
176 {
177 splits.push_back(finalToken);
178 }
179 return splits;
180 }
181
189 template<StringImplicitlyConstructible T = std::string>
190 std::vector<T> split(const std::string& s, char delimiter, bool includeEmpty = true)
191 {
192 return split<T>(s, std::string(1, delimiter), includeEmpty);
193 }
194}
195
196#endif // STRINGHELPERS_H
Definition stringhelpers.h:33
std::string str(const std::wstring &s)
Converts the wstring to a string.
std::string encode(const std::vector< std::byte > &bytes)
Converts a list of bytes into a base64 encoded string.
std::string newUuid()
Generates a new uuid value.
bool isValidUrl(const std::string &s)
Gets whether or not the provided string is a valid url.
std::vector< std::string > splitArgs(std::string s)
Splits a string based on argument delimiters.
std::wstring wstr(const std::string &s)
Converts the string to a wstring.
std::vector< T > split(const std::string &s, const std::string &delimiter, bool includeEmpty=true)
Splits a string based on a delimiter.
Definition stringhelpers.h:159
std::string lower(std::string s)
Gets a fully lowercase string from the provided string.
std::vector< std::byte > decode(const std::string &base64)
Converts a base64 encoded string into a list of bytes.
std::string normalizeForFilename(const std::string &s, bool windowsOnly=false)
Normalizes a string for use in a filename.
std::string trim(const std::string &s)
Trims whitespace form the beginning and end of a string.
std::string upper(std::string s)
Gets a fully uppercase string from the provided string.
std::string newGuid()
Generates a new guid value.
std::string join(const std::vector< std::string > &values, const std::string &separator, bool separateLast=false)
Concatenates the elements of a string list using the specified separator between each element.
std::string replace(std::string s, const std::string &toReplace, const std::string &replace)
Replaces a substring within a string with a new string.
unsigned int stoui(const std::string &s, size_t *idx=nullptr, int base=10)
Converts a string to an unsigned int.