string.hpp File Reference

String types and assorted functions. More...

#include "libfilezilla.hpp"
#include <algorithm>
#include <cstdint>
#include <string>
#include <string_view>
#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-insensitive keys. More...
class	strtokenizer< String, Delims >
	Container-like class that can be used to iterate over tokens in a string. More...
struct	strtokenizer< String, Delims >::sentinel
struct	strtokenizer< String, Delims >::iterator

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...
typedef std::wstring_view	native_string_view

Functions
native_string	to_native (std::string_view const &in)
	Converts std::string to native_string. More...
native_string	to_native (std::wstring_view const &in)
	Convert std::wstring to native_string. More...
template<typename T , typename std::enable_if_t< std::is_same_v< native_string, typename std::decay_t< T >>, int > = 0>
native_string	to_native (T const &in)
	Avoid converting native_string to native_string_view and back to native_string.
int	stricmp (std::string_view const &a, std::string_view const &b)
	Locale-sensitive stricmp. More...
int	stricmp (std::wstring_view const &a, std::wstring_view 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)
std::string	str_tolower_ascii (std::string_view const &s)
	tr_tolower_ascii does for strings what tolower_ascii does for individual characters
std::wstring	str_tolower_ascii (std::wstring_view const &s)
std::string	str_toupper_ascii (std::string_view const &s)
std::wstring	str_toupper_ascii (std::wstring_view const &s)
bool	equal_insensitive_ascii (std::string_view a, std::string_view b)
	Locale-insensitive stricmp. More...
bool	equal_insensitive_ascii (std::wstring_view a, std::wstring_view b)
std::wstring	to_wstring (std::string_view const &in)
	Converts from std::string in system encoding into std::wstring. More...
template<typename T >
auto	to_wstring (T &&in) -> decltype(std::wstring(std::forward< T >(in)))
	Returns identity, that way to_wstring can be called with native_string. More...
template<typename Arg >
std::enable_if< std::is_arithmetic_v< std::decay_t< Arg > >, std::wstring >::type	to_wstring (Arg &&arg)
	Converts from arithmetic type to std::wstring.
std::wstring	to_wstring_from_utf8 (std::string_view 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::wstring	to_wstring_from_utf8 (fz::buffer const &in)
std::string	to_string (std::wstring_view const &in)
	Converts from std::wstring into std::string in system encoding. More...
template<typename T >
auto	to_string (T &&in) -> decltype(std::string(std::forward< T >(in)))
	Returns identity, that way to_wstring can be called with native_string. More...
template<typename Arg >
std::enable_if< std::is_arithmetic_v< std::decay_t< Arg > >, 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_view const &in)
	Converts from std::string in native encoding into std::string in UTF-8. More...
std::string	to_utf8 (std::wstring_view 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_v< String, std::string >, 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...
std::string	replaced_substrings (std::string_view const &in, std::string_view const &find, std::string_view const &replacement)
	Returns in with all occurrences of find in the input string replaced with replacement. More...
std::wstring	replaced_substrings (std::wstring_view const &in, std::wstring_view const &find, std::wstring_view const &replacement)
std::string	replaced_substrings (std::string_view const &in, char find, char replacement)
	Returns in with all occurrences of find in the input string replaced with replacement.
std::wstring	replaced_substrings (std::wstring_view const &in, wchar_t find, wchar_t replacement)
bool	replace_substrings (std::string &in, std::string_view const &find, std::string_view const &replacement)
	Modifies in, replacing all occurrences of find with replacement. More...
bool	replace_substrings (std::wstring &in, std::wstring_view const &find, std::wstring_view const &replacement)
bool	replace_substrings (std::string &in, char find, char replacement)
	Modifies in, replacing all occurrences of find with replacement.
bool	replace_substrings (std::wstring &in, wchar_t find, wchar_t replacement)
template<typename String , typename Delims >
	strtokenizer (String &&string, Delims &&delims, bool ignore_empty) -> strtokenizer< String, Delims >
	strtokenizer class construction-guide. More...
std::vector< std::string >	strtok (std::string_view const &tokens, std::string_view const &delims, bool const ignore_empty=true)
	Tokenizes string. More...
std::vector< std::wstring >	strtok (std::wstring_view const &tokens, std::wstring_view const &delims, bool const ignore_empty=true)
auto	strtok (std::string_view const &tokens, char const delim, bool const ignore_empty=true)
auto	strtok (std::wstring_view const &tokens, wchar_t const delim, bool const ignore_empty=true)
std::vector< std::string_view >	strtok_view (std::string_view const &tokens, std::string_view const &delims, bool const ignore_empty=true)
	Tokenizes string. More...
std::vector< std::wstring_view >	strtok_view (std::wstring_view const &tokens, std::wstring_view const &delims, bool const ignore_empty=true)
auto	strtok_view (std::string_view const &tokens, char const delim, bool const ignore_empty=true)
auto	strtok_view (std::wstring_view const &tokens, wchar_t const delim, bool const ignore_empty=true)
template<typename T >
T	to_integral (std::string_view const &s, T const errorval=T())
	Converts string to integral type T. If string is not convertible, errorval is returned.
template<typename T >
T	to_integral (std::wstring_view const &s, T const errorval=T())
template<typename T , typename StringType >
T	to_integral (std::basic_string_view< StringType > 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.
std::string	trimmed (std::string_view s, std::string_view const &chars=" \r\n\t", bool fromLeft=true, bool fromRight=true)
	Return passed string with all leading and trailing whitespace removed.
std::wstring	trimmed (std::wstring_view s, std::wstring_view const &chars=L" \r\n\t", bool fromLeft=true, bool fromRight=true)
std::string	ltrimmed (std::string_view s, std::string_view const &chars=" \r\n\t")
std::wstring	ltrimmed (std::wstring_view s, std::wstring_view const &chars=L" \r\n\t")
std::string	rtrimmed (std::string_view s, std::string_view const &chars=" \r\n\t")
std::wstring	rtrimmed (std::wstring_view s, std::wstring_view const &chars=L" \r\n\t")
template<typename String , typename std::enable_if_t< std::is_same_v< typename String::value_type, char >, int > = 0>
void	trim (String &s, std::string_view const &chars=" \r\n\t", bool fromLeft=true, bool fromRight=true)
	Remove all leading and trailing whitespace from string.
template<typename String , typename std::enable_if_t< std::is_same_v< typename String::value_type, wchar_t >, int > = 0>
void	trim (String &s, std::wstring_view const &chars=L" \r\n\t", bool fromLeft=true, bool fromRight=true)
template<typename String , typename std::enable_if_t< std::is_same_v< typename String::value_type, char >, int > = 0>
void	ltrim (String &s, std::string_view const &chars=" \r\n\t")
template<typename String , typename std::enable_if_t< std::is_same_v< typename String::value_type, wchar_t >, int > = 0>
void	ltrim (String &s, std::wstring_view const &chars=L" \r\n\t")
template<typename String , typename std::enable_if_t< std::is_same_v< typename String::value_type, char >, int > = 0>
void	rtrim (String &s, std::string_view const &chars=" \r\n\t")
template<typename String , typename std::enable_if_t< std::is_same_v< typename String::value_type, wchar_t >, int > = 0>
void	rtrim (String &s, std::wstring_view const &chars=L" \r\n\t")
template<bool insensitive_ascii = false, typename String >
bool	starts_with (String const &s, String const &beginning)
	Tests whether the first string starts with the second string. More...
template<bool insensitive_ascii = false, typename String >
bool	ends_with (String const &s, String const &ending)
	Tests whether the first string ends with the second string. More...
std::string	normalize_hyphens (std::string_view const &in)
std::wstring	normalize_hyphens (std::wstring_view const &in)
bool	is_valid_utf8 (std::string_view s)
	Verifies that the input data is valid UTF-8.
bool	is_valid_utf8 (std::string_view s, size_t &state)
	Verifies that the input data is valid UTF-8. More...
void	unicode_codepoint_to_utf8_append (std::string &result, uint32_t codepoint)
	Encodes a valid Unicode codepoint as UTF-8 and appends it to the passed string. More...
bool	utf16be_to_utf8_append (std::string &result, std::string_view data, uint32_t &state)
	Converts from UTF-16-BE and appends it to the passed string. More...
bool	utf16le_to_utf8_append (std::string &result, std::string_view data, uint32_t &state)
	Just as utf16be_to_utf8_append but for little-endian UTF-16.
native_string	to_native_from_utf8 (std::string_view s)

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, nonblocking_process.cpp, and process.cpp.