1 #ifndef LIBFILEZILLA_STRING_HEADER
2 #define LIBFILEZILLA_STRING_HEADER
34 typedef std::wstring_view native_string_view;
36 #if defined(FZ_UNIX) || defined(FZ_MAC)
38 typedef std::string_view native_string_view;
45 native_string FZ_PUBLIC_SYMBOL
to_native(std::string_view
const& in);
51 native_string FZ_PUBLIC_SYMBOL
to_native(std::wstring_view
const& in);
54 template<
typename T,
typename std::enable_if_t<std::is_same_v<native_
string,
typename std::decay_t<T>>,
int> = 0>
65 int FZ_PUBLIC_SYMBOL
stricmp(std::string_view
const& a, std::string_view
const& b);
66 int FZ_PUBLIC_SYMBOL
stricmp(std::wstring_view
const& a, std::wstring_view
const& b);
85 template<
typename Char>
87 if (c >=
'A' && c <=
'Z') {
88 return c + (
'a' -
'A');
94 std::wstring::value_type FZ_PUBLIC_SYMBOL
tolower_ascii(std::wstring::value_type c);
97 template<
typename Char>
99 if (c >=
'a' && c <=
'z') {
100 return c + (
'A' -
'a');
106 std::wstring::value_type FZ_PUBLIC_SYMBOL
toupper_ascii(std::wstring::value_type c);
114 std::string FZ_PUBLIC_SYMBOL str_toupper_ascii(std::string_view
const& s);
115 std::wstring FZ_PUBLIC_SYMBOL str_toupper_ascii(std::wstring_view
const& s);
125 bool operator()(T
const& lhs, T
const& rhs)
const {
126 return std::lexicographical_compare(lhs.cbegin(), lhs.cend(), rhs.cbegin(), rhs.cend(),
127 [](
typename T::value_type
const& a,
typename T::value_type
const& b) {
140 return std::equal(a.cbegin(), a.cend(), b.cbegin(), b.cend(),
141 [](
auto const& a,
auto const& b) {
148 return std::equal(a.cbegin(), a.cend(), b.cbegin(), b.cend(),
149 [](
auto const& a,
auto const& b) {
159 std::wstring FZ_PUBLIC_SYMBOL
to_wstring(std::string_view
const& in);
160 inline std::wstring FZ_PUBLIC_SYMBOL
to_wstring(std::wstring_view
const& in) {
return std::wstring(in); }
166 template<
typename T,
typename std::enable_if_t<std::is_same_v<std::w
string,
typename std::decay_t<T>>,
int> = 0>
172 template<
typename Arg>
173 inline typename std::enable_if<std::is_arithmetic_v<std::decay_t<Arg>>, std::wstring>::type
to_wstring(Arg && arg)
193 std::string FZ_PUBLIC_SYMBOL
to_string(std::wstring_view
const& in);
194 inline std::string FZ_PUBLIC_SYMBOL
to_string(std::string_view
const& in) {
return std::string(in); }
200 template<
typename T,
typename std::enable_if_t<std::is_same_v<std::
string,
typename std::decay_t<T>>,
int> = 0>
207 template<
typename Arg>
208 inline typename std::enable_if<std::is_arithmetic_v<std::decay_t<Arg>>, std::string>::type
to_string(Arg && arg)
215 template<
typename Char>
217 return std::char_traits<Char>::length(str);
227 std::string FZ_PUBLIC_SYMBOL
to_utf8(std::string_view
const& in);
235 std::string FZ_PUBLIC_SYMBOL
to_utf8(std::wstring_view
const& in);
238 template<
typename String,
typename Arg>
239 inline auto toString(Arg&& arg) ->
typename std::enable_if<std::is_same_v<String, std::string>, decltype(
to_string(std::forward<Arg>(arg)))>::type
241 return to_string(std::forward<Arg>(arg));
244 template<
typename String,
typename Arg>
245 inline auto toString(Arg&& arg) ->
typename std::enable_if<std::is_same_v<String, std::wstring>, decltype(
to_wstring(std::forward<Arg>(arg)))>::type
250 #if !defined(fzT) || defined(DOXYGEN)
256 #define fzT(x) L ## x
267 template<
typename Char>
270 template<>
inline char const*
choose_string(
char const* c,
wchar_t const*) {
return c; }
271 template<>
inline wchar_t const*
choose_string(
char const*,
wchar_t const* w) {
return w; }
273 #if !defined(fzS) || defined(DOXYGEN)
285 #define fzS(Char, s) fz::choose_string<Char>(s, L ## s)
292 std::string FZ_PUBLIC_SYMBOL
replaced_substrings(std::string_view
const& in, std::string_view
const& find, std::string_view
const& replacement);
293 std::wstring FZ_PUBLIC_SYMBOL
replaced_substrings(std::wstring_view
const& in, std::wstring_view
const& find, std::wstring_view
const& replacement);
296 std::string FZ_PUBLIC_SYMBOL
replaced_substrings(std::string_view
const& in,
char find,
char replacement);
297 std::wstring FZ_PUBLIC_SYMBOL
replaced_substrings(std::wstring_view
const& in,
wchar_t find,
wchar_t replacement);
303 bool FZ_PUBLIC_SYMBOL
replace_substrings(std::string& in, std::string_view
const& find, std::string_view
const& replacement);
304 bool FZ_PUBLIC_SYMBOL
replace_substrings(std::wstring& in, std::wstring_view
const& find, std::wstring_view
const& replacement);
307 bool FZ_PUBLIC_SYMBOL
replace_substrings(std::string& in,
char find,
char replacement);
308 bool FZ_PUBLIC_SYMBOL
replace_substrings(std::wstring& in,
wchar_t find,
wchar_t replacement);
316 std::vector<std::string> FZ_PUBLIC_SYMBOL
strtok(std::string_view
const& tokens, std::string_view
const& delims,
bool const ignore_empty =
true);
317 std::vector<std::wstring> FZ_PUBLIC_SYMBOL
strtok(std::wstring_view
const& tokens, std::wstring_view
const& delims,
bool const ignore_empty =
true);
318 inline auto FZ_PUBLIC_SYMBOL
strtok(std::string_view
const& tokens,
char const delim,
bool const ignore_empty =
true) {
319 return strtok(tokens, std::string_view(&delim, 1), ignore_empty);
321 inline auto FZ_PUBLIC_SYMBOL
strtok(std::wstring_view
const& tokens,
wchar_t const delim,
bool const ignore_empty =
true) {
322 return strtok(tokens, std::wstring_view(&delim, 1), ignore_empty);
333 std::vector<std::string_view> FZ_PUBLIC_SYMBOL
strtok_view(std::string_view
const& tokens, std::string_view
const& delims,
bool const ignore_empty =
true);
334 std::vector<std::wstring_view> FZ_PUBLIC_SYMBOL
strtok_view(std::wstring_view
const& tokens, std::wstring_view
const& delims,
bool const ignore_empty =
true);
335 inline auto FZ_PUBLIC_SYMBOL
strtok_view(std::string_view
const& tokens,
char const delim,
bool const ignore_empty =
true) {
336 return strtok_view(tokens, std::string_view(&delim, 1), ignore_empty);
338 inline auto FZ_PUBLIC_SYMBOL
strtok_view(std::wstring_view
const& tokens,
wchar_t const delim,
bool const ignore_empty =
true) {
339 return strtok_view(tokens, std::wstring_view(&delim, 1), ignore_empty);
343 template<
typename T,
typename String>
344 T to_integral_impl(String
const& s, T
const errorval = T())
346 if constexpr (std::is_same_v<T, bool>) {
347 return static_cast<T
>(to_integral_impl<unsigned int>(s,
static_cast<unsigned int>(errorval))) != 0;
349 else if constexpr (std::is_enum_v<T>) {
350 return static_cast<T
>(to_integral_impl<std::underlying_type_t<T>>(s,
static_cast<std::underlying_type_t<T>
>(errorval)));
354 auto it = s.cbegin();
355 if (it != s.cend() && (*it ==
'-' || *it ==
'+')) {
359 if (it == s.cend()) {
363 for (; it != s.cend(); ++it) {
365 if (c < '0' || c >
'9') {
372 if (!s.empty() && s.front() ==
'-') {
373 ret *=
static_cast<T
>(-1);
381 T
to_integral(std::string_view
const& s, T
const errorval = T()) {
382 return to_integral_impl<T>(s, errorval);
386 T
to_integral(std::wstring_view
const& s, T
const errorval = T()) {
387 return to_integral_impl<T>(s, errorval);
390 template<
typename T,
typename StringType>
391 T
to_integral(std::basic_string_view<StringType>
const& s, T
const errorval = T()) {
392 return to_integral_impl<T>(s, errorval);
397 template<
typename String>
399 for (
auto const& c : s) {
400 if (
static_cast<std::make_unsigned_t<typename String::value_type>
>(c) > 127) {
409 template<
typename String,
typename Chars>
410 void trim_impl(String & s, Chars
const& chars,
bool fromLeft,
bool fromRight) {
411 size_t const first = fromLeft ? s.find_first_not_of(chars) : 0;
412 if (first == String::npos) {
417 size_t const last = fromRight ? s.find_last_not_of(chars) : s.size();
418 if (last == String::npos) {
424 s = s.substr(first, last - first + 1);
428 inline std::string FZ_PUBLIC_SYMBOL
trimmed(std::string_view s, std::string_view
const& chars =
" \r\n\t",
bool fromLeft =
true,
bool fromRight =
true)
430 trim_impl(s, chars, fromLeft, fromRight);
431 return std::string(s);
434 inline std::wstring FZ_PUBLIC_SYMBOL
trimmed(std::wstring_view s, std::wstring_view
const& chars = L
" \r\n\t",
bool fromLeft =
true,
bool fromRight =
true)
436 trim_impl(s, chars, fromLeft, fromRight);
437 return std::wstring(s);
440 inline std::string FZ_PUBLIC_SYMBOL ltrimmed(std::string_view s, std::string_view
const& chars =
" \r\n\t")
442 trim_impl(s, chars,
true,
false);
443 return std::string(s);
446 inline std::wstring FZ_PUBLIC_SYMBOL ltrimmed(std::wstring_view s, std::wstring_view
const& chars = L
" \r\n\t")
448 trim_impl(s, chars,
true,
false);
449 return std::wstring(s);
452 inline std::string FZ_PUBLIC_SYMBOL rtrimmed(std::string_view s, std::string_view
const& chars =
" \r\n\t")
454 trim_impl(s, chars,
false,
true);
455 return std::string(s);
458 inline std::wstring FZ_PUBLIC_SYMBOL rtrimmed(std::wstring_view s, std::wstring_view
const& chars = L
" \r\n\t")
460 trim_impl(s, chars,
false,
true);
461 return std::wstring(s);
466 template<
typename String,
typename std::enable_if_t<std::is_same_v<
typename String::value_type,
char>,
int> = 0>
467 inline void trim(String & s, std::string_view
const& chars =
" \r\n\t",
bool fromLeft =
true,
bool fromRight =
true)
469 trim_impl(s, chars, fromLeft, fromRight);
472 template<
typename String,
typename std::enable_if_t<std::is_same_v<
typename String::value_type,
wchar_t>,
int> = 0>
473 inline void trim(String & s, std::wstring_view
const& chars = L
" \r\n\t",
bool fromLeft =
true,
bool fromRight =
true)
475 trim_impl(s, chars, fromLeft, fromRight);
478 template<
typename String,
typename std::enable_if_t<std::is_same_v<
typename String::value_type,
char>,
int> = 0>
479 inline void ltrim(String& s, std::string_view
const& chars =
" \r\n\t")
481 trim_impl(s, chars,
true,
false);
484 template<
typename String,
typename std::enable_if_t<std::is_same_v<
typename String::value_type,
wchar_t>,
int> = 0>
485 inline void ltrim(String& s, std::wstring_view
const& chars = L
" \r\n\t")
487 trim_impl(s, chars,
true,
false);
490 template<
typename String,
typename std::enable_if_t<std::is_same_v<
typename String::value_type,
char>,
int> = 0>
491 inline void rtrim(String& s, std::string_view
const& chars =
" \r\n\t")
493 trim_impl(s, chars,
false,
true);
496 template<
typename String,
typename std::enable_if_t<std::is_same_v<
typename String::value_type,
wchar_t>,
int> = 0>
497 inline void rtrim(String & s, std::wstring_view
const& chars = L
" \r\n\t")
499 trim_impl(s, chars,
false,
true);
506 template<
bool insensitive_ascii = false,
typename String>
509 if (beginning.size() > s.size()) {
512 if constexpr (insensitive_ascii) {
513 return std::equal(beginning.begin(), beginning.end(), s.begin(), [](
typename String::value_type
const& a,
typename String::value_type
const& b) {
518 return std::equal(beginning.begin(), beginning.end(), s.begin());
526 template<
bool insensitive_ascii = false,
typename String>
529 if (ending.size() > s.size()) {
533 if constexpr (insensitive_ascii) {
534 return std::equal(ending.rbegin(), ending.rend(), s.rbegin(), [](
typename String::value_type
const& a,
typename String::value_type
const& b) {
539 return std::equal(ending.rbegin(), ending.rend(), s.rbegin());
auto toString(Arg &&arg) -> typename std::enable_if< std::is_same_v< String, std::string >, decltype(to_string(std::forward< Arg >(arg)))>::type
Calls either fz::to_string or fz::to_wstring depending on the passed template argument.
Definition: string.hpp:239
T to_integral(std::string_view const &s, T const errorval=T())
Converts string to integral type T. If string is not convertible, errorval is returned.
Definition: string.hpp:381
Comparator to be used for std::map for case-insensitive keys.
Definition: string.hpp:122
bool starts_with(String const &s, String const &beginning)
Tests whether the first string starts with the second string.
Definition: string.hpp:507
bool replace_substrings(std::string &in, std::string_view const &find, std::string_view const &replacement)
Modifies in, replacing all occurrences of find with replacement.
std::wstring to_wstring(std::string_view const &in)
Converts from std::string in system encoding into std::wstring.
Char toupper_ascii(Char c)
Converts ASCII lowercase characters to uppercase as if C-locale is used.
Definition: string.hpp:98
native_string to_native(std::string_view const &in)
Converts std::string to native_string.
std::string to_utf8(std::string_view const &in)
Converts from std::string in native encoding into std::string in UTF-8.
std::vector< std::string_view > strtok_view(std::string_view const &tokens, std::string_view const &delims, bool const ignore_empty=true)
Tokenizes string.
std::string trimmed(std::string_view s, std::string_view const &chars=" \r\n\t", bool fromLeft=true, bool fromRight=true)
Return passed string with all leading and trailing whitespace removed.
Definition: string.hpp:428
bool equal_insensitive_ascii(std::string_view a, std::string_view b)
Locale-insensitive stricmp.
Definition: string.hpp:138
std::string replaced_substrings(std::string_view const &in, std::string_view const &find, std::string_view const &replacement)
Returns in with all occurrences of find in the input string replaced with replacement.
Char tolower_ascii(Char c)
Converts ASCII uppercase characters to lowercase as if C-locale is used.
Definition: string.hpp:86
std::enable_if< std::is_arithmetic_v< std::decay_t< Arg > >, std::string >::type to_string(Arg &&arg)
Converts from arithmetic type to std::string.
Definition: string.hpp:208
std::wstring to_wstring_from_utf8(std::string_view const &in)
Converts from std::string in UTF-8 into std::wstring.
size_t strlen(Char const *str)
Returns length of 0-terminated character sequence. Works with both narrow and wide-characters.
Definition: string.hpp:216
std::string normalize_hyphens(std::string_view const &in)
bool str_is_ascii(String const &s)
Returns true iff the string only has characters in the 7-bit ASCII range.
Definition: string.hpp:398
std::string str_tolower_ascii(std::string_view const &s)
tr_tolower_ascii does for strings what tolower_ascii does for individual characters ...
bool ends_with(String const &s, String const &ending)
Tests whether the first string ends with the second string.
Definition: string.hpp:527
std::wstring native_string
A string in the system's native character type and encoding. Note: This typedef changes depending on...
Definition: string.hpp:33
void trim(String &s, std::string_view const &chars=" \r\n\t", bool fromLeft=true, bool fromRight=true)
Remove all leading and trailing whitespace from string.
Definition: string.hpp:467
The namespace used by libfilezilla.
Definition: apply.hpp:17
Char const * choose_string(char const *c, wchar_t const *w)
Returns the function argument of the type matching the template argument.
Definition: string.hpp:270
std::vector< std::string > strtok(std::string_view const &tokens, std::string_view const &delims, bool const ignore_empty=true)
Tokenizes string.
Sets some global macros and further includes string.hpp.
int stricmp(std::string_view const &a, std::string_view const &b)
Locale-sensitive stricmp.
The buffer class is a simple buffer where data can be appended at the end and consumed at the front...
Definition: buffer.hpp:25
std::enable_if< std::is_arithmetic_v< std::decay_t< Arg > >, std::wstring >::type to_wstring(Arg &&arg)
Converts from arithmetic type to std::wstring.
Definition: string.hpp:173
std::string to_string(std::wstring_view const &in)
Converts from std::wstring into std::string in system encoding.