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
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
|
/* Copyright (c) 2006, 2025, Oracle and/or its affiliates.
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License, version 2.0,
as published by the Free Software Foundation.
This program is designed to work with certain software (including
but not limited to OpenSSL) that is licensed under separate terms,
as designated in a particular file or component or in included license
documentation. The authors of MySQL hereby grant you an additional
permission to link the program and your derivative works with the
separately licensed software that they have either included with
the program or referenced in the documentation.
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, version 2.0, for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA */
#ifndef STRFUNC_INCLUDED
#define STRFUNC_INCLUDED
#include <stddef.h>
#include <sys/types.h>
#include <cstring>
#include <utility>
#include "lex_string.h"
#include "m_ctype.h"
#include "my_inttypes.h"
#include "mysql/mysql_lex_string.h" // MYSQL_LEX_CSTRING
class THD;
struct MEM_ROOT;
struct TYPELIB;
ulonglong find_set(const TYPELIB *lib, const char *x, size_t length,
const CHARSET_INFO *cs, const char **err_pos, uint *err_len,
bool *set_warning);
uint find_type(const TYPELIB *lib, const char *find, size_t length,
bool part_match);
uint find_type2(const TYPELIB *lib, const char *find, size_t length,
const CHARSET_INFO *cs);
uint check_word(TYPELIB *lib, const char *val, const char *end,
const char **end_of_word);
char *flagset_to_string(THD *thd, LEX_STRING *result, ulonglong set,
const char *lib[]);
char *set_to_string(THD *thd, LEX_STRING *result, ulonglong set,
const char *lib[]);
char *set_to_string(THD *thd, LEX_STRING *result, ulonglong set,
const char *lib[], bool quoted);
size_t strconvert(const CHARSET_INFO *from_cs, const char *from,
CHARSET_INFO *to_cs, char *to, size_t to_length,
uint *errors);
/**
Return a LEX_CSTRING handle to a std::string like (meaning something
which has the c_str() and length() member functions). Note that the
std::string-like object retains ownership of the character array,
and consequently the returned LEX_CSTRING is only valid as long as the
std::string-like object is valid.
@param s std::string-like object
@return LEX_CSTRING handle to string
*/
template <class STDSTRINGLIKE_TYPE>
MYSQL_LEX_CSTRING lex_cstring_handle(const STDSTRINGLIKE_TYPE &s) {
return {s.c_str(), s.length()};
}
/**
Lowercase a string according to charset.
@param ci pointer to charset for conversion
@param s string to lower-case
@retval modified argument if r-value
@retval copy of modified argument if lvalue (meaningless, don't use)
*/
template <class STRLIKE_TYPE>
STRLIKE_TYPE casedn(const CHARSET_INFO *ci, STRLIKE_TYPE &&s) {
s.resize(ci->casedn_multiply * s.size());
s.resize(my_casedn_str(ci, &s.front()));
return std::forward<STRLIKE_TYPE>(s);
}
/**
Lowercase a string according to charset. Overload for const T& which
copies argument and forwards to T&& overload.
@param ci pointer to charset for conversion
@param src string to lower-case
@retval modified copy of argument
*/
template <class STRLIKE_TYPE>
STRLIKE_TYPE casedn(const CHARSET_INFO *ci, const STRLIKE_TYPE &src) {
return casedn(ci, STRLIKE_TYPE{src});
}
/**
Create a LEX_STRING in a MEM_ROOT and copy the given string
into it.
@param mem_root MEM_ROOT where to allocate the LEX_STRING.
@param str string to be copied into the LEX_STRING.
@param length length of str, in bytes
@return nullptr on failure, or pointer to the LEX_STRING object
*/
LEX_STRING *make_lex_string_root(MEM_ROOT *mem_root, const char *str,
size_t length);
/**
Copy the given string into a LEX_STRING, allocating it in the
given MEM_ROOT.
@param mem_root MEM_ROOT where to allocate the string.
@param lex_str LEX_STRING to fill with the copied string.
@param str string to be copied into the LEX_STRING.
@param length length of str, in bytes
@return true on failure (OOM), false otherwise.
*/
bool lex_string_strmake(MEM_ROOT *mem_root, LEX_STRING *lex_str,
const char *str, size_t length);
/**
Copy the given string into a LEX_CSTRING, allocating it in the
given MEM_ROOT.
@param mem_root MEM_ROOT where to allocate the string.
@param lex_str LEX_CSTRING to fill with the copied string.
@param str string to be copied into the LEX_CSTRING.
@param length length of str, in bytes
@return true on failure (OOM), false otherwise.
*/
bool lex_string_strmake(MEM_ROOT *mem_root, LEX_CSTRING *lex_str,
const char *str, size_t length);
/**
Utility function for copying a LEX_STRING_TYPE (either LEX_STRING
or LEX_CSTRING) onto a mem_root.
@param mem_root Where to allocate
@param s Source string to copy.
@return LEX_STRING_TYPE referring to the mem_root allocated string.
*/
template <class LEX_STRING_TYPE>
inline LEX_STRING_TYPE LexStringDupRoot(MEM_ROOT *mem_root, LEX_STRING_TYPE s) {
return {strmake_root(mem_root, s.str, s.length), s.length};
}
/**
Utility function for copying a LEX_STRING_TYPE (either LEX_STRING
or LEX_CSTRING) onto a mem_root, but which does not allocate space
for empty strings. If called on a zero-length string EMPTY_CSTR is
returned (where str is "").
@param mem_root Where to allocate
@param s Source string to copy.
@return LEX_STRING_TYPE referring to the mem_root allocated string,
or EMPTY_CSTR.
*/
template <class LEX_STRING_TYPE>
inline LEX_STRING_TYPE LexStringDupRootUnlessEmpty(MEM_ROOT *mem_root,
LEX_STRING_TYPE s) {
return s.length == 0 ? LEX_CSTRING{"", 0} : LexStringDupRoot(mem_root, s);
}
/**
Utility function for collating (using strnncoll) two LEX_STRING_TYPEs.
Saves the boiler plate and casting needed when calling the function directly.
*/
template <class LEX_STRING_TYPE>
inline int strnncmp_nopads(const CHARSET_INFO &cs, LEX_STRING_TYPE &&a,
LEX_STRING_TYPE &&b) {
return cs.coll->strnncoll(
&cs, pointer_cast<const unsigned char *>(a.str), a.length,
pointer_cast<const unsigned char *>(b.str), b.length, false);
}
#endif /* STRFUNC_INCLUDED */
|
