string.hpp File Reference

String types and assorted functions. More...

#include "libfilezilla.hpp"
#include <algorithm>
#include <string>
#include <vector>

Include dependency graph for string.hpp:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Classes
struct	less_insensitive_ascii
	Comparator to be used for std::map for case-insentitive keys. More...

Namespaces
	fz
	The namespace used by libfilezilla.

Macros
#define	fzT(x)   L ## x
	Macro for a string literal in system-native character type. Note: Macro definition changes depending on platform! More...
#define	fzS(Char, s)   fz::choose_string<Char>(s, L ## s)
	Macro to get const pointer to a string of the corresponding type. More...

Typedefs
typedef std::wstring	native_string
	A string in the system's native character type and encoding. Note: This typedef changes depending on platform! More...

Functions
native_string	to_native (std::string const &in)
	Converts std::string to native_string. More...
native_string	to_native (std::wstring const &in)
	Convert std::wstring to native_string. More...
int	stricmp (std::string const &a, std::string const &b)
	Locale-sensitive stricmp. More...
int	stricmp (std::wstring const &a, std::wstring const &b)
template<typename Char >
Char	tolower_ascii (Char c)
	Converts ASCII uppercase characters to lowercase as if C-locale is used. More...
template<>
std::wstring::value_type	tolower_ascii (std::wstring::value_type c)
template<typename Char >
Char	toupper_ascii (Char c)
	Converts ASCII lowercase characters to uppercase as if C-locale is used.
template<>
std::wstring::value_type	toupper_ascii (std::wstring::value_type c)
template<typename String >
String	str_tolower_ascii (String const &s)
	tr_tolower_ascii does for strings what tolower_ascii does for individual characters
template<typename String >
String	str_toupper_ascii (String const &s)
std::wstring	to_wstring (std::string const &in)
	Converts from std::string in system encoding into std::wstring. More...
std::wstring	to_wstring (std::wstring const &in)
	Returns identity, that way to_wstring can be called with native_string.
template<typename Arg >
std::enable_if< std::is_arithmetic< std::decay_t< Arg > >::value, std::wstring >::type	to_wstring (Arg &&arg)
	Converts from arithmetic type to std::wstring.
std::wstring	to_wstring_from_utf8 (std::string const &in)
	Converts from std::string in UTF-8 into std::wstring. More...
std::wstring	to_wstring_from_utf8 (char const *s, size_t len)
std::string	to_string (std::wstring const &in)
	Converts from std::wstring into std::string in system encoding. More...
std::string	to_string (std::string const &in)
	Returns identity, that way to_string can be called with native_string.
template<typename Arg >
std::enable_if< std::is_arithmetic< std::decay_t< Arg > >::value, std::string >::type	to_string (Arg &&arg)
	Converts from arithmetic type to std::string.
template<typename Char >
size_t	strlen (Char const *str)
	Returns length of 0-terminated character sequence. Works with both narrow and wide-characters.
std::string	to_utf8 (std::string const &in)
	Converts from std::string in native encoding into std::string in UTF-8. More...
std::string	to_utf8 (std::wstring const &in)
	Converts from std::wstring in native encoding into std::string in UTF-8. More...
template<typename String , typename Arg >
auto	toString (Arg &&arg) -> typename std::enable_if< std::is_same< String, std::string >::value, decltype(to_string(std::forward< Arg >(arg)))>::type
	Calls either fz::to_string or fz::to_wstring depending on the passed template argument.
template<typename Char >
Char const *	choose_string (char const *c, wchar_t const *w)
	Returns the function argument of the type matching the template argument. More...
template<>
char const *	choose_string (char const *c, wchar_t const *)
	Returns the function argument of the type matching the template argument. More...
template<>
wchar_t const *	choose_string (char const *, wchar_t const *w)
	Returns the function argument of the type matching the template argument. More...
std::string	replaced_substrings (std::string const &in, std::string const &find, std::string const &replacement)
	Returns in with all occurrences of find in the input string replaced with replacement.
std::wstring	replaced_substrings (std::wstring const &in, std::wstring const &find, std::wstring const &replacement)
void	replace_substrings (std::string &in, std::string const &find, std::string const &replacement)
	Modifies in, replacing all occurrences of find with replacement.
void	replace_substrings (std::wstring &in, std::wstring const &find, std::wstring const &replacement)
template<typename String , typename Delim , typename Container = std::vector<String>>
Container	strtok (String const &s, Delim const &delims)
	Tokenizes string. Returns all non-empty substrings.
template<typename T , typename String >
T	to_integral (String const &s, T const errorval=T())
template<typename String >
bool	str_is_ascii (String const &s)
	Returns true iff the string only has characters in the 7-bit ASCII range.
template<typename String >
String	trimmed (String const &s, String const &chars=fz::choose_string< typename String::value_type >(" \\, L" \\\"), bool fromLeft=true, bool fromRight=true)
	Return passed string with all leading and trailing whitespace removed.
template<typename String >
String	ltrimmed (String const &s, String const &chars=fz::choose_string< typename String::value_type >(" \\, L" \\\"))
template<typename String >
String	rtrimmed (String const &s, String const &chars=fz::choose_string< typename String::value_type >(" \\, L" \\\"))
template<typename String >
void	trim (String &s, String const &chars=fz::choose_string< typename String::value_type >(" \\, L" \\\"))
	Remove all leading and trailing whitespace from string.
template<typename String >
void	ltrim (String &s, String const &chars=fz::choose_string< typename String::value_type >(" \\, L" \\\"))
template<typename String >
void	rtrim (String &s, String const &chars=fz::choose_string< typename String::value_type >(" \\, L" \\\"))
template<typename String >
bool	starts_with (String const &s, String const &beginning)
template<typename String >
bool	ends_with (String const &s, String const &ending)

Detailed Description

String types and assorted functions.

Defines the fz::native_string type and offers various functions to convert between different string types.

Macro Definition Documentation

fzS

#define fzS	(		Char,
			s
	)		fz::choose_string<Char>(s, L ## s)

Macro to get const pointer to a string of the corresponding type.

Useful when using string literals in templates where the type of string is a template argument:

template<typename String>
String append_foo(String const& s) {
    s += fzS(String::value_type, "foo");
}

fzT

#define fzT

(

x

)

L ## x

Macro for a string literal in system-native character type.
Note: Macro definition changes depending on platform!

Example: fzT("this string is wide on Windows and narrow elsewhere")

Examples:

list.cpp, and process.cpp.