Very simple string class with some useful features. More...

Public Types
using	char_type = T

Public Member Functions
	basic_string ()
	Default constructor.

	basic_string (const self_type &other)
	Constructor.

template<class B , class A >
	basic_string (const dcpp::nub::basic_string< B, A > &other)
	Constructor from other string types.

	basic_string (const double number)
	Constructs a string from a float.

	basic_string (int number)
	Constructs a string from an int.

	basic_string (unsigned int number)
	Constructs a string from an unsigned int.

	basic_string (long number)
	Constructs a string from a long.

	basic_string (unsigned long number)
	Constructs a string from an unsigned long.

template<class B >
	basic_string (const B *const c, dcpp::u32 length)
	Constructor for copying a string from a pointer with a given length.

template<class B >
	basic_string (const B *const c)
	Constructor for Unicode and ASCII strings.

virtual	~basic_string ()
	Destructor.

self_type &	operator= (const self_type &other)
	Assignment operator.

template<class B , class A >
self_type &	operator= (const dcpp::nub::basic_string< B, A > &other)
	Assignment operator for other string types.

template<class B >
self_type &	operator= (const B *const c)
	Assignment operator for strings, ASCII and Unicode.

self_type	operator+ (const self_type &other) const
	Append operator for other strings.

template<class B >
self_type	operator+ (const B *const c) const
	Append operator for strings, ASCII and Unicode.

T &	operator[] (const dcpp::u32 index)
	Direct access operator.

const T &	operator[] (const dcpp::u32 index) const
	Direct access operator.

bool	operator== (const T *const str) const
	Equality operator.

bool	operator== (const self_type &other) const
	Equality operator.

bool	operator< (const self_type &other) const
	Is smaller comparator.

bool	operator!= (const T *const str) const
	Inequality operator.

bool	operator!= (const self_type &other) const
	Inequality operator.

dcpp::u32	size () const
	Returns length of the string's content.

bool	empty () const

void	clear (bool releaseMemory=true)

const T *	data () const
	Returns character string.

std::basic_string< T >	str () const
	Returns std::string or std::wstring. The traits_type and allocator_type of the returned std::basic_string are the same as those from std::string or std::wstring.

	operator std::basic_string< T > () const
	Returns std::string or std::wstring. The traits_type and allocator_type of the returned std::basic_string are the same as those from std::string or std::wstring. Note that this type operator is marked explicit.

self_type &	make_lower ()
	Makes the string lower case.

self_type &	make_upper ()
	Makes the string upper case.

bool	equals_ignore_case (const self_type &other) const
	Compares the strings ignoring case.

bool	equals_substring_ignore_case (const self_type &other, const dcpp::i32 sourcePos=0) const
	Compares the strings ignoring case.

bool	lower_ignore_case (const self_type &other) const
	Compares the strings ignoring case.

bool	equalsn (const self_type &other, dcpp::u32 n) const
	compares the first n characters of the strings

bool	equalsn (const T *const str, dcpp::u32 n) const
	compares the first n characters of the strings

self_type &	append (T character)
	Appends a character to this string.

self_type &	append (const T *const other, dcpp::u32 length=0xffffffff)
	Appends a char string to this string.

self_type &	append (const self_type &other)
	Appends a string to this string.

self_type &	append (const self_type &other, dcpp::u32 length)
	Appends a string of the length l to this string.

self_type &	insert (dcpp::u32 pos, const char *s, dcpp::u32 n)
	Insert a certain amount of characters into the string before the given index.

void	reserve (dcpp::u32 count)
	Reserves some memory.

dcpp::i32	findFirst (T c) const
	finds first occurrence of character in string

dcpp::i32	findFirstChar (const T *const c, dcpp::u32 count=1) const
	finds first occurrence of a character of a list in string

template<class B >
dcpp::i32	findFirstCharNotInList (const B *const c, dcpp::u32 count=1) const
	Finds first position of a character not in a given list.

template<class B >
dcpp::i32	findLastCharNotInList (const B *const c, dcpp::u32 count=1) const
	Finds last position of a character not in a given list.

dcpp::i32	findNext (T c, dcpp::u32 startPos) const
	finds next occurrence of character in string

dcpp::i32	findLast (T c, dcpp::i32 start=-1) const
	finds last occurrence of character in string

dcpp::i32	findLastChar (const T *const c, dcpp::u32 count=1) const
	finds last occurrence of a character of a list in string

template<class B >
dcpp::i32	find (const B *const str, const dcpp::u32 start=0) const
	finds another string in this string

self_type	subString (dcpp::u32 begin, dcpp::i32 length, bool make_lower=false) const
	Returns a substring.

self_type &	operator+= (T c)
	Appends a character to this string.

self_type &	operator+= (const T *const c)
	Appends a char string to this string.

self_type &	operator+= (const self_type &other)
	Appends a string to this string.

self_type &	operator+= (const int i)
	Appends a string representation of a number to this string.

self_type &	operator+= (const unsigned int i)
	Appends a string representation of a number to this string.

self_type &	operator+= (const long i)
	Appends a string representation of a number to this string.

self_type &	operator+= (const unsigned long i)
	Appends a string representation of a number to this string.

self_type &	operator+= (const double i)
	Appends a string representation of a number to this string.

self_type &	operator+= (const float i)
	Appends a string representation of a number to this string.

self_type &	replace (T toReplace, T replaceWith)
	Replaces all characters of a special type with another one.

self_type &	replace (const self_type &toReplace, const self_type &replaceWith)
	Replaces all instances of a string with another one.

self_type &	remove (T c)
	Removes characters from a string.

self_type &	remove (const self_type &toRemove)
	Removes a string from the string.

self_type &	removeChars (const self_type &characters)
	Removes characters from a string.

self_type &	trim (const self_type &whitespace=" \t\n\r")
	Trims the string.

self_type &	eraseTrailingFloatZeros (char decimalPoint='.')
	Erase 0's at the end when a string ends with a floating point number.

self_type &	erase (dcpp::u32 index)
	Erases a character from the string.

self_type &	validate ()
	verify the existing string.

T	lastChar () const
	gets the last char of a string or null

template<class container >
dcpp::u32	split (container &ret, const T *const delimiter, dcpp::u32 countDelimiters=1, bool ignoreEmptyTokens=true, bool keepSeparators=false) const
	Split string into parts (tokens).

Friends
size_t	multibyteToWString (dcpp::nub::wstring &destination, const char *source, dcpp::u32 sourceSize)
	Internally used by the other multibyteToWString functions.

Detailed Description

template<typename T, typename TAlloc>
class dcpp::nub::basic_string< T, TAlloc >

Very simple string class with some useful features.

basic_string<dcpp::c8> and basic_string<wchar_t> both accept Unicode AND ASCII/Latin-1, so you can assign Unicode to basic_string<dcpp::c8> and ASCII/Latin-1 to basic_string<wchar_t> (and the other way round) if you want to.

However, note that the conversation between both is not done using any encoding. This means that dcpp::c8 strings are treated as ASCII/Latin-1, not UTF-8, and are simply expanded to the equivalent wchar_t, while Unicode/wchar_t characters are truncated to 8-bit ASCII/Latin-1 characters, discarding all other information in the wchar_t.

Helper functions for converting between UTF-8 and wchar_t are provided outside the string class for explicit use.

other	other String to append to this string.
length	How much characters of the other string to add to this one.

other	Char string to append.
length	The length of the string to append.

other	Other string to compare.
sourcePos	where to start to compare in the string

other	Other string to compare.
n	Number of characters to compare

c	List of characters to find. For example if the method should find the first occurrence of 'a' or 'b', this parameter should be "ab".
count	Amount of characters in the list. Usually, this should be strlen(c)

c	List of characters not to find. For example if the method should find the first occurrence of a character not 'a' or 'b', this parameter should be "ab".
count	Amount of characters in the list. Usually, this should be strlen(c)

c	Character to search for.
start	start to search reverse ( default = -1, on end )

c	List of strings to find. For example if the method should find the last occurrence of 'a' or 'b', this parameter should be "ab".
count	Amount of characters in the list. Usually, this should be strlen(c)

c	Character to search for.
startPos	Position in string to start searching.

toReplace	The string to replace.
replaceWith	The string replacing the old one.

toReplace	Character to replace.
replaceWith	Character replacing the old one.

ret	The result container. Tokens are added, the container is not cleared.
delimiter	C-style string of delimiter characters
countDelimiters	Number of delimiter characters
ignoreEmptyTokens	Flag to avoid empty substrings in the result container. If two delimiters occur without a character in between or an empty substring would be placed in the result. Or if a delimiter is the last character an empty substring would be added at the end. If this flag is set, only non-empty strings are stored.
keepSeparators	Flag which allows to add the separator to the result string. If this flag is true, the concatenation of the substrings results in the original string. Otherwise, only the characters between the delimiters are returned.

begin	Start of substring.
length	Length of substring.
make_lower	copy only lower case

Public Types

Public Member Functions

Friends

Detailed Description

Member Function Documentation

◆ append() [1/4]

◆ append() [2/4]

◆ append() [3/4]

◆ append() [4/4]

◆ data()

◆ empty()

◆ equals_ignore_case()

◆ equals_substring_ignore_case()

◆ equalsn() [1/2]

◆ equalsn() [2/2]

◆ erase()

◆ eraseTrailingFloatZeros()

◆ find()

◆ findFirst()

◆ findFirstChar()

◆ findFirstCharNotInList()

◆ findLast()

◆ findLastChar()

◆ findLastCharNotInList()

◆ findNext()

◆ lower_ignore_case()

◆ operator std::basic_string< T >()

◆ operator+=() [1/9]

◆ operator+=() [2/9]

◆ operator+=() [3/9]

◆ operator+=() [4/9]

◆ operator+=() [5/9]

◆ operator+=() [6/9]

◆ operator+=() [7/9]

◆ operator+=() [8/9]

◆ operator+=() [9/9]

◆ remove() [1/2]

◆ remove() [2/2]

◆ removeChars()

◆ replace() [1/2]

◆ replace() [2/2]

◆ reserve()

◆ size()

◆ split()

◆ str()

◆ subString()

◆ trim()