#include <string.hpp>

Inheritance diagram for TString< TChar >:

Collaboration diagram for TString< TChar >:

Class Description

template<typename TChar>
class aworx::lib::strings::TString< TChar >

This class is the base class of all ALib string classes. Objects of this type represent character strings whose data is allocated outside their scope. In particular, the class does not allocate a character array buffer to store and manipulate string data.

Once constructed, objects of this class are immutable, except for the possibility to assign a complete new object value. This means, there is no interface to change the single two data members buffer and length. The immutable nature of this type is lifted by derived types. While class Substring allows to change the start and length of the string represented, class AString holds a copy of the data and consequently allows to modify the string stored.

See also: For an introduction into the ALib string classes see this module's Programmer's Manual.

Template Parameters

TChar The character type.
Alias names for specializations of this class using character types character, nchar, wchar, xchar, complementChar and strangeChar are provided in namespace aworx with type definitions String, NString, WString, XString, ComplementString and StrangeString.

Definition at line 42 of file strings/fwds.hpp.

Inner Classes
class	TRandomAccessIterator

Public Methods
Constructors

constexpr	TString () noexcept=default

constexpr	TString (const TString &) noexcept=default

constexpr	TString (TString &&) noexcept=default

TString &	operator= (const TString &) noexcept=default

TString &	operator= (TString &&) noexcept=default

constexpr	TString (const TChar *pBuffer, integer pLength) noexcept

template<typename TCharArray >
constexpr	TString (const TCharArray &src)

template<typename TCharArray >
	operator TCharArray () const

template<typename TCharArray >
	operator TCharArray () const

template<bool TCheck = true>
ALIB_WARNINGS_IGNORE_IF_CONSTEXPR TString< TChar >	Substring (integer regionStart, integer regionLength=MAX_LEN) const

Buffer Access, Length and State

constexpr const TChar *	Buffer () const

constexpr integer	Length () const

integer	WStringLength () const

constexpr bool	IsNull () const

constexpr bool	IsNotNull () const

constexpr bool	IsEmpty () const

constexpr bool	IsNotEmpty () const

Character Access

template<bool TCheck = true>
TChar	CharAt (integer idx) const

template<bool TCheck = true>
TChar	CharAtStart () const

template<bool TCheck = true>
TChar	CharAtEnd () const

TChar	operator[] (integer idx) const

std::size_t	Hashcode () const

std::size_t	HashcodeIgnoreCase () const

template<Case TSensitivity = Case::Sensitive>
bool	Equals (const TString< TChar > &rhs) const

template<bool TCheck = true, Case TSensitivity = Case::Sensitive>
int	CompareTo (const TString< TChar > &rhs) const

template<bool TCheck = true, Case TSensitivity = Case::Sensitive>
int	CompareTo (const TString &rhs, integer rhsRegionStart, integer rhsRegionLength=MAX_LEN) const

template<bool TCheck = true, Case TSensitivity = Case::Sensitive>
int	CompareTo (const TString &rhs, integer rhsRegionStart, integer rhsRegionLength, integer regionStart, integer regionLength=MAX_LEN) const

template<bool TCheck = true, Case TSensitivity = Case::Sensitive>
bool	ContainsAt (const TString &needle, integer pos) const

template<bool TCheck = true, Case TSensitivity = Case::Sensitive>
bool	StartsWith (const TString &needle) const

template<bool TCheck = true, Case TSensitivity = Case::Sensitive>
bool	EndsWith (const TString &needle) const

Search

template<bool TCheck = true>
integer	IndexOf (TChar needle, integer startIdx=0) const

template<bool TCheck = true>
integer	IndexOf (TChar needle, integer regionStart, integer regionLength) const

integer	IndexOfOrLength (TChar needle) const

template<bool TCheck = true>
ALIB_WARNINGS_ALLOW_UNSAFE_BUFFER_USAGE integer	IndexOfOrLength (TChar needle, integer startIdx) const

template<bool TCheck = true>
ALIB_WARNINGS_RESTORE integer	LastIndexOf (TChar needle, integer startIndex=MAX_LEN) const

template<Inclusion TInclusion, bool TCheck = true>
integer	IndexOfAny (const TString &needles, integer startIdx=0) const

template<Inclusion TInclusion, bool TCheck = true>
integer	LastIndexOfAny (const TString &needles, integer startIdx=MAX_LEN) const

template<bool TCheck = true, Case TSensitivity = Case::Sensitive>
integer	IndexOf (const TString &needle, integer startIdx=0) const

template<bool TCheck = true>
integer	IndexOfFirstDifference (const TString &needle, Case sensitivity=Case::Sensitive, integer idx=0) const

integer	IndexOfSegmentEnd (TChar opener, TChar closer, integer idx) const

template<bool TCheck = true>
integer	CountChar (TChar needle, integer startPos=0) const

template<bool TCheck = true>
integer	CountChar (TChar needle, TChar omit, integer startPos) const

template<bool TCheck = true, Case TSensitivity = Case::Sensitive>
integer	Count (const TString &needle, integer startPos=0) const

template<bool TCheck = true, Case TSensitivity = Case::Sensitive>
integer	Count (const TString &needle, const TString &omit, integer startPos=0) const

Parsing Numbers

ALIB_API uint64_t	ParseDecDigits (integer startIdx=0, integer *newIdx=nullptr) const

ALIB_API int64_t	ParseInt (integer startIdx=0, TNumberFormat< TChar > numberFormat=nullptr, integer newIdx=nullptr) const

int64_t	ParseInt (TNumberFormat< TChar > numberFormat, integer newIdx=nullptr) const

int64_t	ParseInt (integer *newIdx) const

int64_t	ParseInt (integer startIdx, integer *newIdx) const

ALIB_API uint64_t	ParseDec (integer startIdx=0, TNumberFormat< TChar > numberFormat=nullptr, integer newIdx=nullptr) const

uint64_t	ParseDec (TNumberFormat< TChar > numberFormat, integer newIdx=nullptr) const

uint64_t	ParseDec (integer *newIdx) const

uint64_t	ParseDec (integer startIdx, integer *newIdx) const

ALIB_API uint64_t	ParseBin (integer startIdx=0, TNumberFormat< TChar > numberFormat=nullptr, integer newIdx=nullptr) const

uint64_t	ParseBin (TNumberFormat< TChar > numberFormat, integer newIdx=nullptr) const

uint64_t	ParseBin (integer *newIdx) const

uint64_t	ParseBin (integer startIdx, integer *newIdx) const

ALIB_API uint64_t	ParseHex (integer startIdx=0, TNumberFormat< TChar > numberFormat=nullptr, integer newIdx=nullptr) const

uint64_t	ParseHex (TNumberFormat< TChar > numberFormat, integer newIdx=nullptr) const

uint64_t	ParseHex (integer *newIdx) const

uint64_t	ParseHex (integer startIdx, integer *newIdx) const

ALIB_API uint64_t	ParseOct (integer startIdx=0, TNumberFormat< TChar > numberFormat=nullptr, integer newIdx=nullptr) const

uint64_t	ParseOct (TNumberFormat< TChar > numberFormat, integer newIdx=nullptr) const

uint64_t	ParseOct (integer *newIdx) const

uint64_t	ParseOct (integer startIdx, integer *newIdx) const

ALIB_API double	ParseFloat (integer startIdx=0, TNumberFormat< TChar > numberFormat=nullptr, integer newIdx=nullptr) const

double	ParseFloat (TNumberFormat< TChar > numberFormat, integer newIdx=nullptr) const

double	ParseFloat (integer *newIdx) const

double	ParseFloat (integer startIdx, integer *newIdx) const

Conversion

integer	CopyTo (TChar *dest) const

Helper Methods

bool	AdjustRegion (integer &regionStart, integer &regionLength) const

Protected Fields
const TChar *	buffer

integer	length

std::iterator_traits

using	ConstIterator = TRandomAccessIterator< const TChar >

using	ConstReverseIterator = std::reverse_iterator< ConstIterator >

ConstIterator	begin () const

ConstIterator	cbegin () const

ALIB_WARNINGS_ALLOW_UNSAFE_BUFFER_USAGE ConstIterator	end () const

ConstIterator	cend () const

ALIB_WARNINGS_RESTORE ConstReverseIterator	rbegin () const

ConstReverseIterator	rend () const

ConstReverseIterator	crbegin () const

ConstReverseIterator	crend () const

	TString (ConstIterator &start, ConstIterator &end)

template<Case TSensitivity = Case::Sensitive>
ALIB_API integer	indexOfString (const TString &needle, integer startIdx) const

Member Typedef Documentation

◆ ConstIterator

using ConstIterator = TRandomAccessIterator<const TChar>

The constant iterator exposed by this character container. A Mutable version is found only in descendant classes (e.g. AString).

Definition at line 2194 of file string.hpp.

◆ ConstReverseIterator

using ConstReverseIterator = std::reverse_iterator<ConstIterator>

The constant reverse iterator exposed by this character container. A Mutable version is found only in descendant classes (e.g. AString).

Definition at line 2198 of file string.hpp.

Constructor & Destructor Documentation

◆ TString() [1/6]

constexpr TString ( )

constexprdefaultnoexcept

Defaulted default constructor

◆ TString() [2/6]

constexpr TString ( const TString< TChar > & )

constexprdefaultnoexcept

Defaulted copy constructor

◆ TString() [3/6]

constexpr TString ( TString< TChar > && )

constexprdefaultnoexcept

Defaulted move constructor

◆ TString() [4/6]

constexpr TString	(	const TChar *	pBuffer,
		integer	pLength
	)

inlineconstexprnoexcept

Constructor accepting a pointer to a character array and a string length.

Parameters

pBuffer	Pointer to the start of the character string to represent.
pLength	The length of the character string to represent.

Definition at line 161 of file string.hpp.

◆ TString() [5/6]

constexpr TString ( const TCharArray & src )

inlineconstexpr

This templated constructor accepts various different kinds of source data. Unlike this documentation suggests, this constructor is internally implemented by a series of different constructors which are selected using template meta programming (i.e. std::enable_if).

Together, the set of constructors provide maximum flexibility by allowing implicit construction with (and assignment of) any built-in or third-party character array type. Some of the constructors are defined using keyword explict.

See also: More information about string construction is provided with chapter 3.1 Construction of the Programmer's Manual of module ALib Strings.

Template Parameters

TCharArray Type that comprises a character array.

Parameters

src	The source object.

◆ TString() [6/6]

TString	(	ConstIterator &	start,
		ConstIterator &	end
	)

inline

Constructs this string using start and end iterators.

Parameters

start	An iterator referencing the start of the string.
end	An iterator referencing the end of the string.

Definition at line 2241 of file string.hpp.

Member Function Documentation

◆ AdjustRegion()

bool AdjustRegion	(	integer &	regionStart,
		integer &	regionLength
	)		const

inline

Adjusts a region given as in/out parameters, to fit to this object's range [0..length].

Parameters

[in,out]	regionStart	The proposed region start which might get adjusted to fit to range [0..length].
[in,out]	regionLength	The proposed region length which might get adjusted to fit to range [0..length].

Returns: Returns true, if the adjusted region is empty.

Definition at line 1959 of file string.hpp.

◆ begin()

ConstIterator begin ( ) const

inline

Returns an iterator pointing to a constant character at the start of this string.

Returns: The start of this string.

Definition at line 2203 of file string.hpp.

◆ Buffer()

constexpr const TChar* Buffer ( ) const

inlineconstexpr

Returns a pointer to the first character of the string we are representing.

Note: The string is not guaranteed to be zero terminated.

Returns: The start of the character array comprising the string represented by this object.

Definition at line 334 of file string.hpp.

◆ cbegin()

ConstIterator cbegin ( ) const

inline

Returns an iterator pointing to a constant character at the start of this string.

Returns: The start of this string.

Definition at line 2207 of file string.hpp.

◆ cend()

ConstIterator cend ( ) const

inline

Returns an iterator pointing behind this string.

Returns: The end of this string.

Definition at line 2216 of file string.hpp.

◆ CharAt()

TChar CharAt ( integer idx ) const

inline

Retrieves the character at the given index. A range check is performed. If this fails, '\0' is returned.

Template Parameters

TCheck Defaults to true which is the normal invocation mode. If false is given, no range check is performed.

Parameters

idx	The index of the character to read.

Returns: The character at the given index, or '\0' if index out of range.

Definition at line 421 of file string.hpp.

◆ CharAtEnd()

TChar CharAtEnd ( ) const

inline

Retrieves the last character. In case of an empty string, '\0' is returned.

Template Parameters

TCheck Defaults to true which is the normal invocation mode. If false is given, no check for an empty or nulled object is performed.

Returns: The last character of the String. If this instance's length is zero, '\0' is returned.

Definition at line 465 of file string.hpp.

◆ CharAtStart()

TChar CharAtStart ( ) const

inline

Retrieves the first character. In case of an empty or nulled string, '\0' is returned.

Template Parameters

TCheck Defaults to true which is the normal invocation mode. If false is given, no check for an empty string object is performed.

Returns: The first character of the String. If this instance's length is zero, '\0' is returned.

Definition at line 443 of file string.hpp.

◆ CompareTo() [1/3]

int CompareTo	(	const TString< TChar > &	rhs,
		integer	rhsRegionStart,
		integer	rhsRegionLength,
		integer	regionStart,
		integer	regionLength = `MAX_LEN`
	)		const

inline

Compares a region of this object with a region of another string-like object.

Template Parameters

TCheck Defaults to true which is the normal invocation mode. If false is given, no check for a nulled comparison object is performed and this string must not be empty. Furthermore, no check is performed whether the given regions fit to this object respectively the other region to the object given with parameter rhs. This also means that the default value of regionLength must not be used in this case.

TSensitivity Determines if comparison is case sensitive (the default) or not.

Parameters

rhs	The string to compare this string with.
rhsRegionStart	The start of the region in rhs to compare this object with.
rhsRegionLength	The length of the region in rhs to compare this object with.
regionStart	The start of the region in this object to compare with
regionLength	The length of the region in this object to compare with. Defaults to MAX_LEN.

Returns

0 if this and rhs are nulled or if both have a length of 0 or if both share the same content
<0 if this is nulled and rhs is not or if this is smaller than rhs.
>0 if this is not nulled but rhs is or if this is greater than rhs.

Definition at line 685 of file string.hpp.

◆ CompareTo() [2/3]

int CompareTo	(	const TString< TChar > &	rhs,
		integer	rhsRegionStart,
		integer	rhsRegionLength = `MAX_LEN`
	)		const

inline

Compares this string with a region of another string-like object.

Template Parameters

TCheck	Defaults to `true` which is the normal invocation mode. If `false` is given, no check for a nulled comparison object is performed and this string must not be empty. Furthermore, no check is performed whether the given region fits to parameter rhs. This also means that the default value must not be used with TCheck==<`false>`.
TSensitivity	Determines if comparison is case sensitive (the default) or not.

Parameters

rhs	The string to compare this string with.
rhsRegionStart	The start of the region in rhs to compare this object with.
rhsRegionLength	The length of the region in rhs to compare this object with. Defaults to MAX_LEN.

Returns

0 if this and rhs are nulled or if both have a length of 0 or if both share the same content
<0 if this is nulled and rhs is not or if this is smaller than rhs.
>0 if this is not nulled but rhs is or if this is greater than rhs.

Definition at line 635 of file string.hpp.

◆ CompareTo() [3/3]

int CompareTo ( const TString< TChar > & rhs ) const

inline

Compares this string with a string-like object.

Template Parameters

TCheck	Defaults to `true` which is the normal invocation mode. If `false` is given, no check for a nulled object (this) is performed and this string must not be of zero length (while rhs might be of zero length).
TSensitivity	Determines if comparison is case sensitive (the default) or not.

Parameters

rhs	The object to compare.

Returns

0 if this and rhs are nulled or if both have a length of 0 or if both share the same content
<0 if this is nulled and rhs is not or if this is smaller than rhs.
>0 if this is not nulled but rhs is or if this is greater than rhs.

Definition at line 585 of file string.hpp.

◆ ContainsAt()

bool ContainsAt	(	const TString< TChar > &	needle,
		integer	pos
	)		const

inline

Returns true, if the contents of the given string-like object is found at the given position.

Note

The following rules apply:

If pos is out of range or needle is nulled, false is returned. (This check only done if TCheck equals true.)
Otherwise, if the length of needle is 0, true is returned.

Template Parameters

TCheck	Defaults to `true` which is the normal invocation mode. If `<false>` is given, no check on parameter pos is performed and needle must not be nulled.
TSensitivity	Determines if comparison is case sensitive (the default) or not.

Parameters

needle	The string to compare with. If it is empty, `true` is returned.
pos	The position to search for needle.

Returns: true if needle is found at the given position. False otherwise.

Definition at line 731 of file string.hpp.

◆ CopyTo()

integer CopyTo ( TChar * dest ) const

inline

Copies this string's contents into a given character buffer. It is the caller's responsibility that dest is large enough, write-enabled, etc.

Parameters

dest	The destination buffer.

Returns: The length of this string.

Definition at line 1939 of file string.hpp.

◆ Count() [1/2]

integer Count	(	const TString< TChar > &	needle,
		const TString< TChar > &	omit,
		integer	startPos = `0`
	)		const

inline

Counts all occurrences of needle, unless followed by omit, starting at startPos to the end of the string.

For empty strings needle, 0 is returned. Also, for empty strings omit, 0 is returned.

Template Parameters

TSensitivity	Case sensitivity of the comparison. Optional and defaults to Case::Sensitive.
TCheck	Defaults to `true` which is the normal invocation mode. If `false` is given, parameter startPos must be valid and needle must not be empty.

Parameters

needle	The string to search for.
omit	Omit occurrence if the given string follows.
startPos	The index to start the counting. Optional and defaults to `0`.

Returns: The index of the first difference in needle.

Definition at line 1373 of file string.hpp.

◆ Count() [2/2]

integer Count	(	const TString< TChar > &	needle,
		integer	startPos = `0`
	)		const

inline

Counts all occurrences of needle from startPos to the end of the string.

For empty strings needle, 0 is returned.

Template Parameters

TCheck	Defaults to `true` which is the normal invocation mode. If `false` is given, parameter startIdx must be valid and needle must not be empty.
TSensitivity	Case sensitivity of the comparison. Optional and defaults to Case::Sensitive.

Parameters

needle	The string to search for.
startPos	The index to start the counting. Optional and defaults to `0`.

Returns: The index of the first difference in needle.

Definition at line 1324 of file string.hpp.

◆ CountChar() [1/2]

integer CountChar	(	TChar	needle,
		integer	startPos = `0`
	)		const

inline

Counts all occurrences of character needle in the range from startPos to the end of the string.

For empty strings needle, 0 is returned.

Template Parameters

TCheck Defaults to true which is the normal invocation mode. If false is given, no range check is performed.

Parameters

needle	The character to search for.
startPos	The index to start the counting. Optional and defaults to `0`.

Returns: The index of the first difference in needle.

Definition at line 1231 of file string.hpp.

◆ CountChar() [2/2]

integer CountChar	(	TChar	needle,
		TChar	omit,
		integer	startPos
	)		const

inline

Counts all occurrences of character needle, unless followed by character omit in the range from startPos to the end of the string.

For empty strings needle, 0 is returned. Also, for empty strings omit, 0 is returned.

Template Parameters

TCheck Defaults to true which is the normal invocation mode. If false is given, no range check is performed.

Parameters

needle	The character to search for.
omit	Omit occurrence if the given character follows.
startPos	The index to start the counting.

Returns: The index of the first difference in needle.

Definition at line 1274 of file string.hpp.

◆ crbegin()

ConstReverseIterator crbegin ( ) const

inline

Returns a reverse iterator pointing to a constant character at the end of this string.

Returns: The last character of this string.

Definition at line 2229 of file string.hpp.

◆ crend()

ConstReverseIterator crend ( ) const

inline

Returns a reverse iterator pointing before the start of this string.

Returns: The character before this string.

Definition at line 2233 of file string.hpp.

◆ end()

ALIB_WARNINGS_ALLOW_UNSAFE_BUFFER_USAGE ConstIterator end ( ) const

inline

Returns an iterator pointing behind this string.

Returns: The end of this string.

Definition at line 2212 of file string.hpp.

◆ EndsWith()

bool EndsWith ( const TString< TChar > & needle ) const

inline

Returns true, if this string ends with the string found in parameter needle. If needle is empty, true is returned.

Template Parameters

TSensitivity Determines if comparison is case sensitive (the default) or not.

Parameters

needle The string to compare the end of this string with. If nulled or empty, true is returned.

Returns: true if needle is found at the end of this, false otherwise.

Definition at line 808 of file string.hpp.

◆ Equals()

bool Equals ( const TString< TChar > & rhs ) const

inline

Compares this string with a string-like object.

true is returned if this and the compared string are nulled or empty. If only one is nulled or empty, false is returned.

Template Parameters

TSensitivity Determines if comparison is case sensitive (the default) or not.

Parameters

rhs	The object to compare.

Returns: true, if contents of this string and the string representation of the given rhs are equal.

Definition at line 547 of file string.hpp.

◆ Hashcode()

std::size_t Hashcode ( ) const

Computes a hash number for the contained string.

Note: If this library is compiled using C++ 17, internally this method is using std::hash<std::string_view<TChar>>. Otherwise a compatible hash function is used.

See also: Alternative method HashcodeIgnoreCase.

Returns: A hash number which is equal for two instances with the same content.

◆ HashcodeIgnoreCase()

std::size_t HashcodeIgnoreCase ( ) const

Computes a hash number for the contained string converted to upper case letters.

See also: Alternative method Hashcode.

Returns: A hash number which is equal for two instances with have the same content if converted to upper case letters.

◆ IndexOf() [1/3]

integer IndexOf	(	const TString< TChar > &	needle,
		integer	startIdx = `0`
	)		const

inline

Searches the given string-like object in this string.

If needle is empty, the adjusted value of startIdx is returned.

Template Parameters

TSensitivity	Case sensitivity of the comparison. Optional and defaults to Case::Sensitive.
TCheck	Defaults to `true` which is the normal invocation mode. If `false` is given, parameter needle must not be empty and startIdx must be in the range of [0 ... Length() - needle.Length()]. This also implies that this string must not be empty.

Parameters

needle	The string to search for.
startIdx	The index to start the search at. Optional and defaults to `0`.

Returns: If the checking of parameters failed or the string is not found, -1 is returned. Otherwise the index of the first occurrence of needle.

Definition at line 1130 of file string.hpp.

◆ IndexOf() [2/3]

integer IndexOf	(	TChar	needle,
		integer	regionStart,
		integer	regionLength
	)		const

inline

Searches a character within a region of this.

Template Parameters

TCheck Defaults to true which is the normal invocation mode. If false is given, no range check is performed.

Parameters

needle	The character to search for.
regionStart	The start of the region to search the character in.
regionLength	The length of the region to search the character in.

Returns: -1 if the character needle is not found. Otherwise the index of its first occurrence.

Definition at line 888 of file string.hpp.

◆ IndexOf() [3/3]

integer IndexOf	(	TChar	needle,
		integer	startIdx = `0`
	)		const

inline

Searches a character starting from a given position.

Template Parameters

TCheck Defaults to true which is the normal invocation mode. If false is given, no range check is performed.

Parameters

needle	The character to search for.
startIdx	The index in this to start searching the character. Defaults to `0`.

Returns: -1 if the character needle is not found. Otherwise the index of its first occurrence.

Definition at line 850 of file string.hpp.

◆ IndexOfAny()

integer IndexOfAny	(	const TString< TChar > &	needles,
		integer	startIdx = `0`
	)		const

inline

Returns the index of the first character which is included, respectively not included in a set of characters given as a string-like object.

Note: In derived class CString, a faster version of this method (using std::strpbrk() respectively std::strspn()) is available. So, if performance is important and repetitive calls are performed, it might be advisable to hold this string and the needles in a zero-terminated string buffer, for example in an AString.

This method searches forwards. For backwards search, see LastIndexOf.

Template Parameters

TInclusion	Denotes whether the search returns the first index that holds a value that is included or that is not excluded in the set of needle characters.
TCheck	Defaults to `true` which is the normal invocation mode. If `<false>` is given, no parameter checks are performed.

Parameters

needles	Pointer to a zero terminated set of characters to be taken into account.
startIdx	The index to start the search at. If the given value is less than 0, it is set to 0. If it exceeds the length of the string, the length of the string is returned. Defaults to 0.

Returns: The index of the first character found which is included, respectively not included, in the given set of characters. If nothing is found, -1 is returned.

Definition at line 1044 of file string.hpp.

◆ IndexOfFirstDifference()

integer IndexOfFirstDifference	(	const TString< TChar > &	needle,
		Case	sensitivity = `Case::Sensitive`,
		integer	idx = `0`
	)		const

inline

Searches the first difference of a sub-string of this string and a string-like object given with parameter needle. If no difference is found, then the index of the first character behind the sub-string is returned.

Template Parameters

TCheck Defaults to true which is the normal invocation mode. If false is given, no range check is performed.

Parameters

needle	The sub-string to search for.
sensitivity	Letter case sensitivity of the comparison. Optional and defaults to Case::Sensitive.
idx	The index in this string to start the comparison with needle. Optional and defaults to `0`.

Returns: The index of the first difference found or idx plus the length of needle.

Definition at line 1168 of file string.hpp.

◆ IndexOfOrLength() [1/2]

integer IndexOfOrLength ( TChar needle ) const

inline

Like IndexOf but in case the character is not found, this method returns the length of this string instead of -1. Depending on the invocation context, the choice for the right version of this method may lead to shorter and more efficient code.

Parameters

needle The character to search for.

Returns: This string's Length if character needle is not found. Otherwise the index of first occurrence.

Definition at line 926 of file string.hpp.

◆ IndexOfOrLength() [2/2]

ALIB_WARNINGS_ALLOW_UNSAFE_BUFFER_USAGE integer IndexOfOrLength	(	TChar	needle,
		integer	startIdx
	)		const

inline

Like IndexOf but in case the character is not found, this method returns the length of this string instead of -1. Depending on the invocation context, the choice for the right version of this method may lead to shorter and more efficient code.

Template Parameters

TCheck Defaults to true which is the normal invocation mode. If false is given, no range check is performed.

Parameters

needle	The character to search for.
startIdx	The index in this to start searching the character.

Returns: This string's Length if character needle is not found. Otherwise the index of first occurrence.

Definition at line 950 of file string.hpp.

◆ IndexOfSegmentEnd()

integer IndexOfSegmentEnd	(	TChar	opener,
		TChar	closer,
		integer	idx
	)		const

The method searches the next matching closer-character while taking nested pairs of opener and closer characters into account.

Prior to the invocation of this method, the initial opener has to be known already and the given idx has to point to the first character behind the opener, where the search for an according closer is to be started.

This method is useful to scan a string for pairs of opening and closing brackets, while the found segment may contain nested pairs of the same brackets.

Parameters

opener	The character that represents the opening bracket, e.g. `'{'`.
closer	The character that represents the closing bracket, e.g. `'}'`.
idx	Index pointing to first character behind the (first) opener.

Returns: The index of the corresponding closing character. If none was found, a negative value is returned. In the latter case the negated (absolute) value is indicating the number of still open (nested) brackets.

◆ indexOfString()

ALIB_API integer indexOfString	(	const TString< TChar > &	needle,
		integer	startIdx
	)		const

protected

Implementation of the sub-string search function.

Template Parameters

TSensitivity The letter case sensitivity of the search.

Parameters

needle	The sub-string to search.
startIdx	The start index of the search.

Returns: The index of the first occurrence of needle, respectively -1 if not found.

◆ IsEmpty()

constexpr bool IsEmpty ( ) const

inlineconstexpr

Returns true if this string is of zero length. Note that a nulled string is also considered empty.

See also: Details on the concept of nulled and empty strings are documented in chapter 6.1.1 Nulled Vs. Empty Strings of this module's Programmer's Manual.

Returns: true if the actual length equals zero.

Definition at line 398 of file string.hpp.

◆ IsNotEmpty()

constexpr bool IsNotEmpty ( ) const

inlineconstexpr

Returns true if this string has a length of 1 or more.

Returns: true if the actual length does not equal zero.

Definition at line 404 of file string.hpp.

◆ IsNotNull()

constexpr bool IsNotNull ( ) const

inlineconstexpr

Returns true if field buffer does not equal nullptr, false otherwise.

Returns: The negated value of method IsNull.

Definition at line 386 of file string.hpp.

◆ IsNull()

constexpr bool IsNull ( ) const

inlineconstexpr

Returns true if field buffer equals nullptr, false otherwise. Note that a nulled string is also considered empty.

See also: Details on the concept of nulled and empty strings are documented in chapter 6.1.1 Nulled Vs. Empty Strings of this module's Programmer's Manual.

Returns: true if no buffer is allocated.

Definition at line 379 of file string.hpp.

◆ LastIndexOf()

ALIB_WARNINGS_RESTORE integer LastIndexOf	(	TChar	needle,
		integer	startIndex = `MAX_LEN`
	)		const

inline

Searches a character starting backwards from the end or a given start index.

Template Parameters

TCheck Defaults to true which is the normal invocation mode. If false is given, no range check is performed. Consequently, in this case, optional parameter startIndex must be provided.

Parameters

needle	The character to search for.
startIndex	The index within this string to start searching the character. Defaults to MAX_LEN.

Returns: -1 if the character needle is not found. Otherwise the index of its last occurrence.

Definition at line 988 of file string.hpp.

◆ LastIndexOfAny()

integer LastIndexOfAny	(	const TString< TChar > &	needles,
		integer	startIdx = `MAX_LEN`
	)		const

inline

Returns the index of the last character which is included, respectively not included in set of characters given as a string-like object.

This method searches backwards starting at the given index. For forwards search, see IndexOfAny.

Template Parameters

TInclusion	Denotes whether the search returns the first index that holds a value that is included or that is not excluded in the set of needle characters.
TCheck	Defaults to `true` which is the normal invocation mode. If `<false>` is given, no parameter checks are performed.

Parameters

needles	Pointer to a zero terminated set of characters to be searched for.
startIdx	The index to start the search at. The value is cropped to be in the bounds of 0 and the length of this object minus one. Defaults to MAX_LEN.

Returns: The index of the first character found which is included, respectively not included, in the given set of characters. If nothing is found, -1 is returned.

Definition at line 1091 of file string.hpp.

◆ Length()

constexpr integer Length ( ) const

inlineconstexpr

Returns the length of the string that this object represents.

Returns: The length of the string represented by this object.

Definition at line 341 of file string.hpp.

◆ operator TCharArray() [1/2]

operator TCharArray ( ) const

inline

Implicit cast operator to objects of templated type TCharArray.
This operator is available for all custom types that have an accordingly specialized version of TMP struct T_CharArray defined.

See also: More information about casting ALib string types to built-in C++ types or custom types is provided with chapter 3.2 Casting Strings To Other Types of the Programmer's Manual of module ALib Strings.

Template Parameters

TCharArray The custom type to implicitly convert this object to.

Returns: A value of custom string type.

Definition at line 205 of file string.hpp.

◆ operator TCharArray() [2/2]

operator TCharArray ( ) const

inlineexplicit

Explicit cast operator to objects of templated type TCharArray.
This operator is available for all custom types that have an accordingly specialized version of TMP struct T_CharArray defined.

See also: More information about casting ALib string types to built-in C++ types or custom types is provided with chapter 3.2 Casting Strings To Other Types of the Programmer's Manual of module ALib Strings.

Template Parameters

TCharArray The custom type to explicitly convert this object to.

Returns: A value of custom string type.

Definition at line 223 of file string.hpp.

◆ operator=() [1/2]

TString& operator= ( const TString< TChar > & )

defaultnoexcept

Defaulted copy assignment operator.

Returns: A reference to this instance.

◆ operator=() [2/2]

TString& operator= ( TString< TChar > && )

defaultnoexcept

Defaulted move assignment operator.

Returns: A reference to this instance.

◆ operator[]()

TChar operator[] ( integer idx ) const

inline

Reads a character at a given index.

Note: Unlike method CharAt, this operator does not perform do range check on parameter idx. The rationale for this is that derived mutable types (e.g. class AString), may provide a mutable (non-const) version of this operator, returning a a reference to the character to provide write access. Such reference to a character could not be given if the index was out of range. This way, a check in the derived type could likewise not be implemented.; As a result, this operator is equivalent to the non-checking version of method CharAt<false>. For safe access to characters in the buffer use CharAt (with template parameter TCheck being true) which returns '\0' in the case of that idx is out of bounds.; Still, in debug-compilations this operator raises an assertion if idx is out of bounds.

Parameters

idx	The index of the character within this object's buffer.

Returns: If the character contained at index idx.

Definition at line 502 of file string.hpp.

◆ ParseBin() [1/4]

uint64_t ParseBin ( integer * newIdx ) const

inline

Overloaded version of ParseBin providing default values for omitted parameters.

Parameters

[out] newIdx Optional output variable that will point to the first character in this string after the number parsed. On failure, it will be set to the initial value 0.

Returns: The parsed value. In addition, the output parameter newIdx is set to point to the first character behind the parsed number.

Definition at line 1659 of file string.hpp.

◆ ParseBin() [2/4]

uint64_t ParseBin	(	integer	startIdx,
		integer *	newIdx
	)		const

inline

Overloaded version of ParseBin providing default values for omitted parameters.

Parameters

	startIdx	The start index for parsing. Optional and defaults to `0`.
[out]	newIdx	Optional output variable that will point to the first character in this string after the number parsed. On failure, it will be set to the initial value startIdx.

Returns: The parsed value. In addition, the output parameter newIdx is set to point to the first character behind the parsed number.

Definition at line 1678 of file string.hpp.

◆ ParseBin() [3/4]

ALIB_API uint64_t ParseBin	(	integer	startIdx = `0`,
		TNumberFormat< TChar > *	numberFormat = `nullptr`,
		integer *	newIdx = `nullptr`
	)		const

Reads an unsigned 64-bit integer in binary format at the given position from this string.

Parameter numberFormat defaults to nullptr. This denotes static singleton NumberFormat::Computational which is configured to not using - and therefore also not parsing - grouping characters.

Optional output parameter newIdx may be used to detect if parsing was successful. If not, it receives the value of startIdx, even if leading whitespaces had been read.

For more information on number conversion, see class NumberFormat. All number-parsing interface methods have a corresponding implementation within this class.

Parameters

	startIdx	The start index for parsing. Optional and defaults to `0`.
	numberFormat	The format definition. Defaults to `nullptr`.
[out]	newIdx	Optional output variable that will point to the first character in this string after the number parsed. On failure, it will be set to the initial value startIdx.

Returns: The parsed value. In addition, the output parameter newIdx is set to point to the first character behind the parsed number.

◆ ParseBin() [4/4]

uint64_t ParseBin	(	TNumberFormat< TChar > *	numberFormat,
		integer *	newIdx = `nullptr`
	)		const

inline

Overloaded version of ParseBin providing default values for omitted parameters.

Parameters

	numberFormat	The format definition. Defaults to `nullptr`.
[out]	newIdx	Optional output variable that will point to the first character in this string after the number parsed. On failure, it will be set to the initial value `0`.

Returns: The parsed value. In addition, the output parameter newIdx is set to point to the first character behind the parsed number.

Definition at line 1643 of file string.hpp.

◆ ParseDec() [1/4]

uint64_t ParseDec ( integer * newIdx ) const

inline

Overloaded version of ParseDec providing default values for omitted parameters.

Parameters

[out] newIdx Optional output variable that will point to the first character in this string after the number parsed. On failure, it will be set to the initial value 0.

Returns: The parsed value. In addition, the output parameter newIdx is set to point to the first character behind the parsed number.

Definition at line 1577 of file string.hpp.

◆ ParseDec() [2/4]

uint64_t ParseDec	(	integer	startIdx,
		integer *	newIdx
	)		const

inline

Overloaded version of ParseDec providing default values for omitted parameters.

Parameters

	startIdx	The start index for parsing. Optional and defaults to `0`.
[out]	newIdx	Optional output variable that will point to the first character in this string after the number parsed. On failure, it will be set to the initial value startIdx.

Returns: The parsed value. In addition, the output parameter newIdx is set to point to the first character behind the parsed number.

Definition at line 1596 of file string.hpp.

◆ ParseDec() [3/4]

ALIB_API uint64_t ParseDec	(	integer	startIdx = `0`,
		TNumberFormat< TChar > *	numberFormat = `nullptr`,
		integer *	newIdx = `nullptr`
	)		const

Reads an unsigned 64-bit integer in standard decimal format at the given position from this AString.

Parameter numberFormat defaults to nullptr. This denotes static singleton TNumberFormat::Computational which is configured to not using - and therefore also not parsing - grouping characters.

Optional output parameter newIdx may be used to detect if parsing was successful. If not, it receives the value of startIdx, even if leading whitespaces had been read.

Sign literals '-' or '+' are not accepted and parsing will fail. For reading signed integral values, see methods ParseInt, for floating point numbers ParseFloat.

For more information on number conversion, see class NumberFormat. All number-parsing interface methods have a corresponding implementation within this class.

Parameters

	startIdx	The start index for parsing. Optional and defaults to `0`.
	numberFormat	The format definition. Defaults to `nullptr`.
[out]	newIdx	Optional output variable that will point to the first character in this string after the number parsed. On failure, it will be set to the initial value startIdx.

Returns: The parsed value. In addition, the output parameter newIdx is set to point to the first character behind the parsed number.

◆ ParseDec() [4/4]

uint64_t ParseDec	(	TNumberFormat< TChar > *	numberFormat,
		integer *	newIdx = `nullptr`
	)		const

inline

Overloaded version of ParseDec providing default values for omitted parameters.

Parameters

	numberFormat	The format definition. Defaults to `nullptr`.
[out]	newIdx	Optional output variable that will point to the first character in this string after the number parsed. On failure, it will be set to the initial value `0`.

Returns: The parsed value. In addition, the output parameter newIdx is set to point to the first character behind the parsed number.

Definition at line 1561 of file string.hpp.

◆ ParseDecDigits()

ALIB_API uint64_t ParseDecDigits	(	integer	startIdx = `0`,
		integer *	newIdx = `nullptr`
	)		const

Parses an integral value consisting of characters '0' to '9' from this string.
Unlike with ParseInt or ParseDec, no sign, whitespaces or group characters are accepted.

Parameters

	startIdx	The start index from where the integral value is tried to be parsed. Optional and defaults to `0`.
[out]	newIdx	Optional output variable that will point to the first character in this string after the float number that was parsed. If parsing fails, it will be set to the value of parameter startIdx. Therefore, this parameter can be used to check if a value was found.

Returns: The parsed value. In addition, the parameter newIdx is set to point to the first character behind any found integer number.

◆ ParseFloat() [1/4]

double ParseFloat ( integer * newIdx ) const

inline

Overloaded version of ParseFloat providing default values for omitted parameters.

Parameters

[out] newIdx Optional output variable that will point to the first character in this string after the number parsed. On failure, it will be set to the initial value 0.

Returns: The parsed value. In addition, the output parameter newIdx is set to point to the first character behind the parsed number.

Definition at line 1904 of file string.hpp.

◆ ParseFloat() [2/4]

double ParseFloat	(	integer	startIdx,
		integer *	newIdx
	)		const

inline

Overloaded version of ParseFloat providing default values for omitted parameters.

Parameters

	startIdx	The start index for parsing. Optional and defaults to `0`.
[out]	newIdx	Optional output variable that will point to the first character in this string after the number parsed. On failure, it will be set to the initial value startIdx.

Returns: The parsed value. In addition, the output parameter newIdx is set to point to the first character behind the parsed number.

Definition at line 1923 of file string.hpp.

◆ ParseFloat() [3/4]

ALIB_API double ParseFloat	(	integer	startIdx = `0`,
		TNumberFormat< TChar > *	numberFormat = `nullptr`,
		integer *	newIdx = `nullptr`
	)		const

Reads a floating point number at the given position from this string.

Parameter numberFormat defaults to nullptr. This denotes static singleton NumberFormat::Computational which is configured to 'international' settings (not using the locale) and therefore also not parsing grouping characters.

Optional output parameter newIdx may be used to detect if parsing was successful. If not, it receives the value of startIdx, even if leading whitespaces had been read.

For more information on number conversion, see class NumberFormat. All number-parsing interface methods have a corresponding implementation within this class.

Parameters

	startIdx	The start index for parsing. Optional and defaults to `0`.
	numberFormat	The format definition. Defaults to `nullptr`.
[out]	newIdx	Optional output variable that will point to the first character in this string after the number parsed. On failure, it will be set to the initial value startIdx.

Returns: The parsed value. In addition, the output parameter newIdx is set to point to the first character behind the parsed number.

◆ ParseFloat() [4/4]

double ParseFloat	(	TNumberFormat< TChar > *	numberFormat,
		integer *	newIdx = `nullptr`
	)		const

inline

Overloaded version of ParseFloat providing default values for omitted parameters.

Parameters

	numberFormat	The format definition. Defaults to `nullptr`.
[out]	newIdx	Optional output variable that will point to the first character in this string after the number parsed. On failure, it will be set to the initial value `0`.

Returns: The parsed value. In addition, the output parameter newIdx is set to point to the first character behind the parsed number.

Definition at line 1888 of file string.hpp.

◆ ParseHex() [1/4]

uint64_t ParseHex ( integer * newIdx ) const

inline

Overloaded version of ParseHex providing default values for omitted parameters.

Parameters

[out] newIdx Optional output variable that will point to the first character in this string after the number parsed. On failure, it will be set to the initial value 0.

Returns: The parsed value. In addition, the output parameter newIdx is set to point to the first character behind the parsed number.

Definition at line 1741 of file string.hpp.

◆ ParseHex() [2/4]

uint64_t ParseHex	(	integer	startIdx,
		integer *	newIdx
	)		const

inline

Overloaded version of ParseHex providing default values for omitted parameters.

Parameters

	startIdx	The start index for parsing. Optional and defaults to `0`.
[out]	newIdx	Optional output variable that will point to the first character in this string after the number parsed. On failure, it will be set to the initial value startIdx.

Returns: The parsed value. In addition, the output parameter newIdx is set to point to the first character behind the parsed number.

Definition at line 1760 of file string.hpp.

◆ ParseHex() [3/4]

ALIB_API uint64_t ParseHex	(	integer	startIdx = `0`,
		TNumberFormat< TChar > *	numberFormat = `nullptr`,
		integer *	newIdx = `nullptr`
	)		const

Reads an unsigned 64-bit integer in hexadecimal format at the given position from this string.

Parameter numberFormat defaults to nullptr. This denotes static singleton NumberFormat::Computational which is configured to not using - and therefore also not parsing - grouping characters.

Optional output parameter newIdx may be used to detect if parsing was successful. If not, it receives the value of startIdx, even if leading whitespaces had been read.

For more information on number conversion, see class NumberFormat. All number-parsing interface methods have a corresponding implementation within this class.

Parameters

	startIdx	The start index for parsing. Optional and defaults to `0`.
	numberFormat	The format definition. Defaults to `nullptr`.
[out]	newIdx	Optional output variable that will point to the first character in this string after the number parsed. On failure, it will be set to the initial value startIdx.

Returns: The parsed value. In addition, the output parameter newIdx is set to point to the first character behind the parsed number.

◆ ParseHex() [4/4]

uint64_t ParseHex	(	TNumberFormat< TChar > *	numberFormat,
		integer *	newIdx = `nullptr`
	)		const

inline

Overloaded version of ParseHex providing default values for omitted parameters.

Parameters

	numberFormat	The format definition. Defaults to `nullptr`.
[out]	newIdx	Optional output variable that will point to the first character in this string after the number parsed. On failure, it will be set to the initial value `0`.

Returns: The parsed value. In addition, the output parameter newIdx is set to point to the first character behind the parsed number.

Definition at line 1725 of file string.hpp.

◆ ParseInt() [1/4]

int64_t ParseInt ( integer * newIdx ) const

inline

Overloaded version of ParseInt providing default values for omitted parameters.

Parameters

[out] newIdx Optional output variable that will point to the first character in this string after the number parsed. On failure, it will be set to the initial value 0.

Returns: The parsed value. In addition, the output parameter newIdx is set to point to the first character behind the parsed number.

Definition at line 1492 of file string.hpp.

◆ ParseInt() [2/4]

int64_t ParseInt	(	integer	startIdx,
		integer *	newIdx
	)		const

inline

Overloaded version of ParseInt providing default values for omitted parameters.

Parameters

	startIdx	The start index for parsing. Optional and defaults to `0`.
[out]	newIdx	Optional output variable that will point to the first character in this string after the number parsed. On failure, it will be set to the initial value startIdx.

Returns: The parsed value. In addition, the output parameter newIdx is set to point to the first character behind the parsed number.

Definition at line 1511 of file string.hpp.

◆ ParseInt() [3/4]

ALIB_API int64_t ParseInt	(	integer	startIdx = `0`,
		TNumberFormat< TChar > *	numberFormat = `nullptr`,
		integer *	newIdx = `nullptr`
	)		const

Parses an integral value in decimal, binary, hexadecimal or octal format from the string

Parameter numberFormat defaults to nullptr. This denotes static singleton NumberFormat::Computational which is configured to not using - and therefore also not parsing - grouping characters.

Optional output parameter newIdx may be used to detect if parsing was successful. If not, it receives the value of startIdx, even if leading whitespaces had been read.

For more information on number conversion, see class NumberFormat. All of its interface methods have a corresponding implementation within class AString.

Parameters

	startIdx	The start index for parsing. Optional and defaults to `0`.
	numberFormat	The format definition. Defaults to `nullptr`.
[out]	newIdx	Optional output variable that will point to the first character in this string after the number parsed. On failure, it will be set to the initial value startIdx.

Returns: The parsed value. In addition, the output parameter newIdx is set to point to the first character behind the parsed number.

◆ ParseInt() [4/4]

int64_t ParseInt	(	TNumberFormat< TChar > *	numberFormat,
		integer *	newIdx = `nullptr`
	)		const

inline

Overloaded version of ParseInt providing default values for omitted parameters.

Parameters

	numberFormat	The format definition. Defaults to `nullptr`.
[out]	newIdx	Optional output variable that will point to the first character in this string after the number parsed. On failure, it will be set to the initial value `0`.

Returns: The parsed value. In addition, the output parameter newIdx is set to point to the first character behind the parsed number.

Definition at line 1476 of file string.hpp.

◆ ParseOct() [1/4]

uint64_t ParseOct ( integer * newIdx ) const

inline

Overloaded version of ParseOct providing default values for omitted parameters.

Parameters

[out] newIdx Optional output variable that will point to the first character in this string after the number parsed. On failure, it will be set to the initial value 0.

Returns: The parsed value. In addition, the output parameter newIdx is set to point to the first character behind the parsed number.

Definition at line 1823 of file string.hpp.

◆ ParseOct() [2/4]

uint64_t ParseOct	(	integer	startIdx,
		integer *	newIdx
	)		const

inline

Overloaded version of ParseOct providing default values for omitted parameters.

Parameters

	startIdx	The start index for parsing. Optional and defaults to `0`.
[out]	newIdx	Optional output variable that will point to the first character in this string after the number parsed. On failure, it will be set to the initial value startIdx.

Returns: The parsed value. In addition, the output parameter newIdx is set to point to the first character behind the parsed number.

Definition at line 1842 of file string.hpp.

◆ ParseOct() [3/4]

ALIB_API uint64_t ParseOct	(	integer	startIdx = `0`,
		TNumberFormat< TChar > *	numberFormat = `nullptr`,
		integer *	newIdx = `nullptr`
	)		const

Reads an unsigned 64-bit integer in octal format at the given position from this string.

Parameter numberFormat defaults to nullptr. This denotes static singleton NumberFormat::Computational which is configured to not using - and therefore also not parsing - grouping characters.

Optional output parameter newIdx may be used to detect if parsing was successful. If not, it receives the value of startIdx, even if leading whitespaces had been read.

For more information on number conversion, see class NumberFormat. All number-parsing interface methods have a corresponding implementation within this class.

Parameters

	startIdx	The start index for parsing. Optional and defaults to `0`.
	numberFormat	The format definition. Defaults to `nullptr`.
[out]	newIdx	Optional output variable that will point to the first character in this string after the number parsed. On failure, it will be set to the initial value startIdx.

Returns: The parsed value. In addition, the output parameter newIdx is set to point to the first character behind the parsed number.

◆ ParseOct() [4/4]

uint64_t ParseOct	(	TNumberFormat< TChar > *	numberFormat,
		integer *	newIdx = `nullptr`
	)		const

inline

Overloaded version of ParseOct providing default values for omitted parameters.

Parameters

	numberFormat	The format definition. Defaults to `nullptr`.
[out]	newIdx	Optional output variable that will point to the first character in this string after the number parsed. On failure, it will be set to the initial value `0`.

Returns: The parsed value. In addition, the output parameter newIdx is set to point to the first character behind the parsed number.

Definition at line 1807 of file string.hpp.

◆ rbegin()

ALIB_WARNINGS_RESTORE ConstReverseIterator rbegin ( ) const

inline

Returns a reverse iterator pointing to a constant character at the end of this string.

Returns: The last character of this string.

Definition at line 2221 of file string.hpp.

◆ rend()

ConstReverseIterator rend ( ) const

inline

Returns a reverse iterator pointing before the start of this string.

Returns: The character before this string.

Definition at line 2225 of file string.hpp.

◆ StartsWith()

bool StartsWith ( const TString< TChar > & needle ) const

inline

Returns true, if this string starts with the contents of the string-like object given with parameter needle. In the special case that needle is empty, true is returned.

Template Parameters

TSensitivity	Determines if comparison is case sensitive (the default) or not.
TCheck	Defaults to `true` which is the normal invocation mode. If `<false>` is given, the given needle must not be empty and must not be longer than this string! pos is performed and needle must not be nulled.

Parameters

needle The string to compare the start of this string with. If nulled or empty, true is returned.

Returns: true if needle is found at the start of this string, false otherwise.

Definition at line 774 of file string.hpp.

◆ Substring()

ALIB_WARNINGS_IGNORE_IF_CONSTEXPR TString<TChar> Substring	(	integer	regionStart,
		integer	regionLength = `MAX_LEN`
	)		const

inline

Returns a new string object representing a sub-string of the string that this object represents.

Template Parameters

TCheck Defaults to true which is the normal invocation mode. If false is given, no range check is performed.

Parameters

regionStart	The start of the sub-string within this string.
regionLength	The length of the sub-string to return. Defaults to MAX_LEN.

Returns: A string representing a region of this string.

Definition at line 298 of file string.hpp.

◆ WStringLength()

integer WStringLength ( ) const

Returns the length of the string if represented as a wide character string. If template parameter TChar equals wchar, then this is identical with Length. Otherwise the calculation is done using

mbsnrtowcs() (without providing a conversion buffer) on glibc platforms (e.g. Linux)
MultiByteToWideChar() (without providing a conversion buffer) on the Windows platform.

If the conversion fails, -1 is returned.

Note: On GNU/Linux and Mac OS, it might be necessary to invoke standard C method setlocale() once, prior to using this method, to successfully calculate the length. This by default is done during library initialization, if performed on class ALibDistribution.

Returns: The length of string when it was converted to wide characters. If counting failed (what means that a corresponding conversion would also fail) the Length is returned.

Member Data Documentation

◆ buffer

const TChar* buffer

protected

Pointer to an array of constant character values. This array holds the string that an instance of this type is representing.
Read access to this field is granted with method Buffer.

For technical reasons, this documentation unfortunaltely omits the important fact that this field is part of an anonymous union declared like this:

 union
 {
     const TChar*   buffer;
           TChar*  vbuffer;
 };

Hence, the field can also be interpreted as a pointer to an array of non-constant character values. Derived classes might use the sibling version vbuffer to modify the contents of the string if it is assured that such memory is writable. This is for example done extensively by the implementation of class AString.

Note: It might not be considered pure/nice OO-design to prepare a feature of specialized classes in a non-abstract base class, as done here. But the alternative would have been to force derived classes to perform re-interpret casts or even worse tricks to rightfully access a writeable buffer.

Definition at line 121 of file string.hpp.

◆ length

integer length

protected

The length of the character string represented. Read access to this field is granted with method Length.

Definition at line 129 of file string.hpp.

The documentation for this class was generated from the following files:

Class Description

template<typename TChar> class aworx::lib::strings::TString< TChar >

Inner Classes

Public Methods

Protected Fields

std::iterator_traits

Member Typedef Documentation

◆ ConstIterator

◆ ConstReverseIterator

Constructor & Destructor Documentation

◆ TString() [1/6]

◆ TString() [2/6]

◆ TString() [3/6]

◆ TString() [4/6]

◆ TString() [5/6]

◆ TString() [6/6]

Member Function Documentation

◆ AdjustRegion()

◆ begin()

◆ Buffer()

◆ cbegin()

◆ cend()

◆ CharAt()

◆ CharAtEnd()

◆ CharAtStart()

◆ CompareTo() [1/3]

◆ CompareTo() [2/3]

◆ CompareTo() [3/3]

◆ ContainsAt()

◆ CopyTo()

◆ Count() [1/2]

◆ Count() [2/2]

◆ CountChar() [1/2]

◆ CountChar() [2/2]

◆ crbegin()

◆ crend()

◆ end()

◆ EndsWith()

◆ Equals()

◆ Hashcode()

◆ HashcodeIgnoreCase()

◆ IndexOf() [1/3]

◆ IndexOf() [2/3]

◆ IndexOf() [3/3]

◆ IndexOfAny()

◆ IndexOfFirstDifference()

◆ IndexOfOrLength() [1/2]

◆ IndexOfOrLength() [2/2]

◆ IndexOfSegmentEnd()

◆ indexOfString()

◆ IsEmpty()

◆ IsNotEmpty()

◆ IsNotNull()

◆ IsNull()

◆ LastIndexOf()

◆ LastIndexOfAny()

◆ Length()

◆ operator TCharArray() [1/2]

◆ operator TCharArray() [2/2]

◆ operator=() [1/2]

◆ operator=() [2/2]

◆ operator[]()

◆ ParseBin() [1/4]

◆ ParseBin() [2/4]

◆ ParseBin() [3/4]

◆ ParseBin() [4/4]

◆ ParseDec() [1/4]

◆ ParseDec() [2/4]

◆ ParseDec() [3/4]

◆ ParseDec() [4/4]

◆ ParseDecDigits()

◆ ParseFloat() [1/4]

◆ ParseFloat() [2/4]

◆ ParseFloat() [3/4]

◆ ParseFloat() [4/4]

◆ ParseHex() [1/4]

◆ ParseHex() [2/4]

◆ ParseHex() [3/4]

◆ ParseHex() [4/4]

◆ ParseInt() [1/4]

template<typename TChar>
class aworx::lib::strings::TString< TChar >