1 /*
2 * Copyright (c) 2021 Huawei Device Co., Ltd.
3 * Licensed under the Apache License, Version 2.0 (the "License");
4 * you may not use this file except in compliance with the License.
5 * You may obtain a copy of the License at
6 *
7 * http://www.apache.org/licenses/LICENSE-2.0
8 *
9 * Unless required by applicable law or agreed to in writing, software
10 * distributed under the License is distributed on an "AS IS" BASIS,
11 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12 * See the License for the specific language governing permissions and
13 * limitations under the License.
14 */
15 #ifndef STRING_EX_H
16 #define STRING_EX_H
17
18 #include <string>
19 #include <vector>
20
21 namespace OHOS {
22
23 /**
24 * The UpperStr function convert all letters of str to uppercase.
25 */
26 std::string UpperStr(const std::string& str);
27
28 /**
29 * The LowerStr function convert all letters of str to lowercase.
30 */
31 std::string LowerStr(const std::string& str);
32
33 /**
34 * The ReplaceStr function will replace src with dst int base.
35 */
36 std::string ReplaceStr(const std::string& str, const std::string& src, const std::string& dst);
37
38 /**
39 * The TrimStr function will trim str by cTrim front and end.
40 */
41 std::string TrimStr(const std::string& str, const char cTrim = ' ');
42
43 /**
44 * The DexToHexString function convert decimal to hexadecimal string.
45 */
46 std::string DexToHexString(int value, bool upper = true);
47
48 /**
49 * The SplitStr function will split str by strSep.
50 */
51 void SplitStr(const std::string& str, const std::string& sep, std::vector<std::string>& strs,
52 bool canEmpty = false, bool needTrim = true);
53
54 /**
55 * The ToString function convert int and double and so on to str.
56 */
57 template<class T>
ToString(T iValue)58 inline std::string ToString(T iValue)
59 {
60 return std::to_string(iValue);
61 }
62
63 /**
64 * The StrToInt function convert str to int.
65 */
66 bool StrToInt(const std::string& str, int& value);
67
68 /**
69 * The IsNumericStr function judge all characters of the string are numbers,
70 * return true if all are numbers, else false.
71 */
72 bool IsNumericStr(const std::string& str);
73
74 /**
75 * The IsAlphaStr function judge all characters of the string are alphabet,
76 * return true if all are alphabet, else false.
77 */
78 bool IsAlphaStr(const std::string& str);
79
80 /**
81 * The IsUpperStr function judge all characters of the string are uppercase,
82 * return true if all are uppercase, else false.
83 */
84 bool IsUpperStr(const std::string& str);
85
86 /**
87 * The IsLowerStr function judge all characters of the string are lowercase,
88 * return true if all are lowercase, else false.
89 */
90 bool IsLowerStr(const std::string& str);
91
92 /**
93 * The IsSubStr function judge the sub in str,
94 * return true if sub in str, else false.
95 */
96 bool IsSubStr(const std::string& str, const std::string& sub);
97
98 /**
99 * The GetFirstSubStrBetween function get the first sub_str between left and right
100 * return the rightstr pos, if failed return string::npos.
101 */
102 std::string::size_type GetFirstSubStrBetween(const std::string& str, const std::string& left,
103 const std::string& right, std::string& sub);
104
105 /**
106 * The GetSubStrBetween function get the sub strings between left and right.
107 */
108 void GetSubStrBetween(const std::string& str, const std::string& left,
109 const std::string& right, std::vector<std::string>& sub);
110
111 /**
112 * The IsSameTextStr function judge the first's letter is same with second,
113 * return true if same, else false.
114 */
115 bool IsSameTextStr(const std::string& first, const std::string& second);
116
117 bool IsAsciiString(const std::string& str);
118
119 /**
120 * The str16ToStr8 function convert string16 to string8.
121 * If convert failed, return an empty string.
122 */
123 std::string Str16ToStr8(const std::u16string& str16);
124
125 /**
126 * The Str8ToStr16 function convert string8 to string16.
127 * If convert failed, return an empty u16string.
128 */
129 std::u16string Str8ToStr16(const std::string& str);
130 } // namespace OHOS
131
132 #endif // STRING_EX_H
133