1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
|
/***
This file is part of snapcast
Copyright (C) 2014-2025 Johannes Pohl
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.
***/
#pragma once
// standard headers
#include <map>
#include <sstream>
#include <string>
#include <vector>
namespace utils::string
{
/// Check of text matches pattern, with pattern containing '*' wildcards
bool wildcardMatch(const std::string& pattern, const std::string& text);
/// trim from start
std::string& ltrim(std::string& s);
/// trim from end
std::string& rtrim(std::string& s);
/// trim from both ends
std::string& trim(std::string& s);
/// trim from start
std::string ltrim_copy(const std::string& s);
/// trim from end
std::string rtrim_copy(const std::string& s);
/// trim from both ends
std::string trim_copy(const std::string& s);
/// decode %xx to char
std::string uriDecode(const std::string& src);
/// @return uri encoded version of @p str
std::string uriEncode(const std::string& str);
/// @return uri encoded version of @p path
std::string uriEncodePath(const std::string& path);
/// Split string @p s at left-most @p delim into @p left and @p right
void split_left(const std::string& s, char delim, std::string& left, std::string& right);
/// Split string @p s at right-most @p delim into @p left and @p right
void split_right(const std::string& s, char delim, std::string& left, std::string& right);
/// Split string @p s at left-most @p delim into left and @p right
/// @return the left part
std::string split_left(const std::string& s, char delim, std::string& right);
/// Split string @p s at right-most @p delim into left and @p right
/// @return the left part
std::string split_right(const std::string& s, char delim, std::string& right);
/// Split string @p s at @p delim and return the splitted list in @p elems
/// @return list of splitted strings
std::vector<std::string>& split(const std::string& s, char delim, std::vector<std::string>& elems);
/// @return resulting list of strings by splitting @p s at @p delim
std::vector<std::string> split(const std::string& s, char delim);
/// Split @p s into key value pairs, separated by @p pair_delim and @p key_value_delim
/// @return map from keys to values
template <typename T>
std::map<std::string, T> split_pairs_to_container(const std::string& s, char pair_delim, char key_value_delim)
{
std::map<std::string, T> result;
auto keyValueList = split(s, pair_delim);
for (const auto& kv : keyValueList)
{
auto pos = kv.find(key_value_delim);
if (pos != std::string::npos)
{
std::string key = trim_copy(kv.substr(0, pos));
std::string value = trim_copy(kv.substr(pos + 1));
result[key].push_back(std::move(value));
}
}
return result;
}
/// @return concatenated values of @p container, separated by @p delim
template <typename T>
std::string container_to_string(const T& container, const std::string& delim = ", ")
{
std::stringstream ss;
for (auto iter = container.begin(); iter != container.end(); ++iter)
{
ss << *iter;
if (std::distance(iter, container.end()) > 1)
ss << delim;
}
return ss.str();
}
/// Split @p s into key value pairs, separated by @p pair_delim and @p key_value_delim
/// @return map from keys to values
std::map<std::string, std::string> split_pairs(const std::string& s, char pair_delim, char key_value_delim);
/// @return @p[in, out] s converted to lowercase
std::string& tolower(std::string& s);
/// @return @p s converted to lowercase
std::string tolower_copy(const std::string& s);
} // namespace utils::string
|
