#include <stddef.h>
#include <sys/types.h>
#include <cstring>
#include <utility>
#include "lex_string.h"
#include "my_inttypes.h"
#include "mysql/mysql_lex_string.h"
#include "mysql/strings/m_ctype.h"
#include "template_utils.h"

Functions
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)

template<class STDSTRINGLIKE_TYPE >
MYSQL_LEX_CSTRING	lex_cstring_handle (const STDSTRINGLIKE_TYPE &s)
	Return a LEX_CSTRING handle to a std::string like (meaning something which has the c_str() and length() member functions). More...

template<class STRLIKE_TYPE >
STRLIKE_TYPE	casedn (const CHARSET_INFO *ci, STRLIKE_TYPE &&s)
	Lowercase a string according to charset. More...

template<class STRLIKE_TYPE >
STRLIKE_TYPE	casedn (const CHARSET_INFO *ci, const STRLIKE_TYPE &src)
	Lowercase a string according to charset. More...

LEX_STRING *	make_lex_string_root (MEM_ROOT mem_root, const char str, size_t length)
	Create a LEX_STRING in a MEM_ROOT and copy the given string into it. More...

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_STRING, allocating it in the given MEM_ROOT. More...

bool	lex_string_strmake (MEM_ROOT mem_root, LEX_CSTRING lex_str, const char *str, size_t length)
	Copy the given string into a LEX_CSTRING, allocating it in the given MEM_ROOT. More...

template<class LEX_STRING_TYPE >
LEX_STRING_TYPE	LexStringDupRoot (MEM_ROOT *mem_root, LEX_STRING_TYPE s)
	Utility function for copying a LEX_STRING_TYPE (either LEX_STRING or LEX_CSTRING) onto a mem_root. More...

template<class LEX_STRING_TYPE >
LEX_STRING_TYPE	LexStringDupRootUnlessEmpty (MEM_ROOT *mem_root, LEX_STRING_TYPE s)
	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. More...

template<class LEX_STRING_TYPE >
int	strnncmp_nopads (const CHARSET_INFO &cs, LEX_STRING_TYPE &&a, LEX_STRING_TYPE &&b)
	Utility function for collating (using strnncoll) two LEX_STRING_TYPEs. More...

Function Documentation

◆ casedn() [1/2]

template<class STRLIKE_TYPE >

STRLIKE_TYPE casedn	(	const CHARSET_INFO *	ci,
		const STRLIKE_TYPE &	src
	)

Lowercase a string according to charset.

Overload for const T& which copies argument and forwards to T&& overload.

Parameters

ci	pointer to charset for conversion
src	string to lower-case

Return values

modified copy of argument

◆ casedn() [2/2]

template<class STRLIKE_TYPE >

STRLIKE_TYPE casedn	(	const CHARSET_INFO *	ci,
		STRLIKE_TYPE &&	s
	)

Lowercase a string according to charset.

Parameters

ci	pointer to charset for conversion
s	string to lower-case

Return values

modified	argument if r-value
copy	of modified argument if lvalue (meaningless, don't use)

◆ check_word()

uint check_word	(	TYPELIB *	lib,
		const char *	val,
		const char *	end,
		const char **	end_of_word
	)

◆ find_set()

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
	)

◆ find_type()

uint find_type	(	const TYPELIB *	lib,
		const char *	find,
		size_t	length,
		bool	part_match
	)

◆ find_type2()

uint find_type2	(	const TYPELIB *	lib,
		const char *	find,
		size_t	length,
		const CHARSET_INFO *	cs
	)

◆ flagset_to_string()

char * flagset_to_string	(	THD *	thd,
		LEX_STRING *	result,
		ulonglong	set,
		const char *	lib[]
	)

◆ lex_cstring_handle()

template<class STDSTRINGLIKE_TYPE >

MYSQL_LEX_CSTRING lex_cstring_handle ( const STDSTRINGLIKE_TYPE & s )

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.

Parameters

s	std::string-like object

Returns: LEX_CSTRING handle to string

◆ lex_string_strmake() [1/2]

bool lex_string_strmake	(	MEM_ROOT *	mem_root,
		LEX_CSTRING *	lex_str,
		const char *	str,
		size_t	length
	)

Copy the given string into a LEX_CSTRING, allocating it in the given MEM_ROOT.

Parameters

mem_root	MEM_ROOT where to allocate the string.
lex_str	LEX_CSTRING to fill with the copied string.
str	string to be copied into the LEX_CSTRING.
length	length of str, in bytes

Returns: true on failure (OOM), false otherwise.

◆ lex_string_strmake() [2/2]

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_STRING, allocating it in the given MEM_ROOT.

Parameters

mem_root	MEM_ROOT where to allocate the string.
lex_str	LEX_STRING to fill with the copied string.
str	string to be copied into the LEX_STRING.
length	length of str, in bytes

Returns: true on failure (OOM), false otherwise.

◆ LexStringDupRoot()

template<class LEX_STRING_TYPE >

LEX_STRING_TYPE LexStringDupRoot	(	MEM_ROOT *	mem_root,
		LEX_STRING_TYPE	s
	)

inline

Utility function for copying a LEX_STRING_TYPE (either LEX_STRING or LEX_CSTRING) onto a mem_root.

Parameters

mem_root	Where to allocate
s	Source string to copy.

Returns: LEX_STRING_TYPE referring to the mem_root allocated string.

◆ LexStringDupRootUnlessEmpty()

template<class LEX_STRING_TYPE >

LEX_STRING_TYPE LexStringDupRootUnlessEmpty	(	MEM_ROOT *	mem_root,
		LEX_STRING_TYPE	s
	)

inline

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 "").

Parameters

mem_root	Where to allocate
s	Source string to copy.

Returns: LEX_STRING_TYPE referring to the mem_root allocated string, or EMPTY_CSTR.

◆ make_lex_string_root()

LEX_STRING * make_lex_string_root	(	MEM_ROOT *	mem_root,
		const char *	str,
		size_t	length
	)

Create a LEX_STRING in a MEM_ROOT and copy the given string into it.

Parameters

mem_root	MEM_ROOT where to allocate the LEX_STRING.
str	string to be copied into the LEX_STRING.
length	length of str, in bytes

Returns: nullptr on failure, or pointer to the LEX_STRING object

◆ set_to_string() [1/2]

char * set_to_string	(	THD *	thd,
		LEX_STRING *	result,
		ulonglong	set,
		const char *	lib[]
	)

◆ set_to_string() [2/2]

char * set_to_string	(	THD *	thd,
		LEX_STRING *	result,
		ulonglong	set,
		const char *	lib[],
		bool	quoted
	)

◆ strconvert()

size_t strconvert	(	const CHARSET_INFO *	from_cs,
		const char *	from,
		CHARSET_INFO *	to_cs,
		char *	to,
		size_t	to_length,
		uint *	errors
	)

◆ strnncmp_nopads()

template<class LEX_STRING_TYPE >

int strnncmp_nopads	(	const CHARSET_INFO &	cs,
		LEX_STRING_TYPE &&	a,
		LEX_STRING_TYPE &&	b
	)

inline

Utility function for collating (using strnncoll) two LEX_STRING_TYPEs.

Saves the boiler plate and casting needed when calling the function directly.

Functions

Function Documentation

◆ casedn() [1/2]

◆ casedn() [2/2]

◆ check_word()

◆ find_set()

◆ find_type()

◆ find_type2()

◆ flagset_to_string()

◆ lex_cstring_handle()

◆ lex_string_strmake() [1/2]

◆ lex_string_strmake() [2/2]

◆ LexStringDupRoot()

◆ LexStringDupRootUnlessEmpty()

◆ make_lex_string_root()

◆ set_to_string() [1/2]

◆ set_to_string() [2/2]

◆ strconvert()

◆ strnncmp_nopads()