alib::strings::TLocalStringNoWarning< TChar, TCapacity, TAllocator > Struct Template Reference

Description:

template<typename TChar, integer TCapacity, typename TAllocator>
struct alib::strings::TLocalStringNoWarning< TChar, TCapacity, TAllocator >

This simple specialization of TLocalString disables the warning about replacements of the internal buffer in debug-compilations. This may be used in situations, where it is not possible to disable this warning after construction, for example, if a local string is emplaced in a container and extensions of it's local capacity are well accepted (for a minority of the emplaced strings).

In release compilations, this type does not exist, but is replaced by a simple using statement.

Template Parameters

TChar	The character type.
TCapacity	The capacity of local, embedded string buffer.
TAllocator	The allocator to use.

Definition at line 269 of file localstring.inl.

Inheritance diagram for alib::strings::TLocalStringNoWarning< TChar, TCapacity, TAllocator >:

Public Method Index:
constexpr	TLocalStringNoWarning ()
	Default constructor.
	TLocalStringNoWarning (const String &src)
Public Method Index: inherited from alib::strings::TLocalString< TChar, TCapacity, TAllocator >
constexpr	TLocalString (TAllocator &pAllocator)
TLocalString &	operator= (const TLocalString &copy)
Public Method Index: inherited from alib::strings::TAString< TChar, TAllocator >
constexpr	TAString ()
	Constructs an empty, nulled AString (does not allocate a buffer).
	TAString (const TAppendable &src)
	TAString (const TAString &copy)
constexpr	TAString (TAllocator &pAllocator)
	TAString (TAString &&move) noexcept
	~TAString () noexcept
	Destructs an AString object. An internally allocated buffer will be deleted.
TAString &	_ ()
TAString &	_ (const TAppendable &src)
TAString &	_ (const TString< TChar > &src, integer regionStart, integer regionLength=MAX_LEN)
TAString &	Append (characters::IsCharacter auto src)
TAString &	Append (const TAppendable &src)
TAString &	Append (const TChar *src, integer srcLength)
TAString &	Append (const TCharSrc *src, integer srcLength)
TAString &	Append (const TString< TChar > &src, integer regionStart, integer regionLength=MAX_LEN)
TAString &	Append (const TStringSource &src)
TAString &	Append (TChar src)
iterator	begin ()
const_iterator	begin () const
integer	Capacity () const
void	dbgCheck () const
void	DbgDisableBufferReplacementWarning ()
TAString &	Delete (integer regionStart, integer regionLength=MAX_LEN)
TAString &	DeleteEnd (const TString< TChar > &deleteIfMatch)
TAString &	DeleteEnd (integer regionLength)
TAString &	DeleteStart (const TString< TChar > &deleteIfMatch)
TAString &	DeleteStart (integer regionLength)
integer	DetectLength (integer offset=0)
iterator	end ()
const_iterator	end () const
void	EnsureRemainingCapacity (integer spaceNeeded)
void	GrowBufferAtLeastBy (integer minimumGrowth)
bool	HasInternalBuffer () const
TAString &	InsertAt (const TString< TChar > &src, integer pos)
TAString &	InsertChars (TChar c, integer qty)
TAString &	InsertChars (TChar c, integer qty, integer pos)
TAString &	InsertUninitialized (integer pos, integer size)
TAString &	NewLine ()
constexpr	operator T () const
TAString &	operator+= (const TAppendable &src)
TAString &	operator<< (const TAppendable &src)
TAString &	operator= (const TAString &copy)
TChar &	operator[] (integer idx)
TChar	operator[] (integer idx) const
constexpr TChar	pop_back ()
constexpr void	push_back (TChar ch)
reverse_iterator	rbegin ()
const_reverse_iterator	rbegin () const
reverse_iterator	rend ()
const_reverse_iterator	rend () const
TAString &	ReplaceRegion (TChar c, integer regionStart, integer regionLength)
TAString &	ReplaceSubstring (const TString< TChar > &src, integer regionStart, integer regionLength)
TAString &	Reset ()
TAString &	Reset (const TAppendable &src)
TAString &	Reverse (integer regionStart=0, integer regionLength=MAX_LEN)
integer	SearchAndReplace (const TString< TChar > &needle, const TString< TChar > &replacement, integer startIdx=0, integer maxReplacements=strings::MAX_LEN, lang::Case sensitivity=lang::Case::Sensitive, integer endIdx=strings::MAX_LEN)
integer	SearchAndReplace (TChar needle, TChar replacement, integer startIdx=0, integer endIdx=strings::MAX_LEN)
void	SetBuffer (integer newCapacity)
void	SetBuffer (TChar *extBuffer, integer extBufferSize, integer extLength=0, lang::Responsibility responsibility=lang::Responsibility::KeepWithSender)
void	SetCharAt (integer idx, TChar c)
void	SetLength (integer newLength)
void	SetNull ()
	Invokes SetBuffer(0).
TAString &	ShortenBy (integer charsToRemove)
TAString &	ShortenTo (integer newLength)
constexpr const TChar *	Terminate () const
TAString &	ToLower (integer regionStart=0, integer regionLength=MAX_LEN)
TAString &	ToUpper (integer regionStart=0, integer regionLength=MAX_LEN)
TAString &	Trim (const TCString< TChar > &trimChars=CStringConstantsTraits< TChar >::DefaultWhitespaces())
integer	TrimAt (integer idx, const TCString< TChar > &trimChars=CStringConstantsTraits< TChar >::DefaultWhitespaces())
TAString &	TrimEnd (const TCString< TChar > &trimChars=CStringConstantsTraits< TChar >::DefaultWhitespaces())
TAString &	TrimStart (const TCString< TChar > &trimChars=CStringConstantsTraits< TChar >::DefaultWhitespaces())
TChar *	VBuffer () const
Public Method Index: inherited from alib::strings::TString< TChar >
constexpr	TString () noexcept=default
template<typename T>
constexpr	TString (const T &src) noexcept
constexpr	TString (const TChar *pBuffer, integer pLength) noexcept
constexpr	TString (const TString &) noexcept=default
	Defaulted copy constructor.
	TString (const_iterator &start, const_iterator &end)
constexpr	TString (lang::IsNullptr auto const &) noexcept
	Constructor accepting nullptr. Constructs a nulled string.
template<typename T>
constexpr	TString (T &src) noexcept
template<typename TAllocator>
	TString (TAllocator &allocator, const TString< TChar > &copy)
constexpr	TString (TString &&) noexcept=default
	Defaulted move constructor.
bool	AdjustRegion (integer &regionStart, integer &regionLength) const
template<typename TAllocator>
void	Allocate (TAllocator &allocator, const TString< TChar > &copy)
const_iterator	begin () const
constexpr const TChar *	Buffer () const
const_iterator	cbegin () const
const_iterator	cend () const
template<typename TCheck = CHK>
TChar	CharAt (integer idx) const
template<typename TCheck = CHK>
TChar	CharAtEnd () const
template<typename TCheck = CHK>
TChar	CharAtStart () const
template<typename TCheck = CHK, lang::Case TSensitivity = lang::Case::Sensitive>
int	CompareTo (const TString &rhs, integer rhsRegionStart, integer rhsRegionLength, integer regionStart, integer regionLength=MAX_LEN) const
template<typename TCheck = CHK, lang::Case TSensitivity = lang::Case::Sensitive>
int	CompareTo (const TString &rhs, integer rhsRegionStart, integer rhsRegionLength=MAX_LEN) const
template<typename TCheck = CHK, lang::Case TSensitivity = lang::Case::Sensitive>
int	CompareTo (const TString< TChar > &rhs) const
template<typename TCheck = CHK, lang::Case TSensitivity = lang::Case::Sensitive>
bool	ContainsAt (const TString &needle, integer pos) const
integer	CopyTo (TChar *dest) const
template<typename TCheck = CHK, lang::Case TSensitivity = lang::Case::Sensitive>
integer	Count (const TString &needle, const TString &omit, integer startPos=0) const
template<typename TCheck = CHK, lang::Case TSensitivity = lang::Case::Sensitive>
integer	Count (const TString &needle, integer startPos=0) const
template<typename TCheck = CHK>
integer	CountChar (TChar needle, integer startPos=0) const
template<typename TCheck = CHK>
integer	CountChar (TChar needle, TChar omit, integer startPos) const
const_reverse_iterator	crbegin () const
const_reverse_iterator	crend () const
const_iterator	end () const
template<typename TCheck = CHK, lang::Case TSensitivity = lang::Case::Sensitive>
bool	EndsWith (const TString &needle) const
template<typename TCheck = CHK, lang::Case TSensitivity = lang::Case::Sensitive>
bool	Equals (const TString< TChar > &rhs) const
template<typename TAllocator>
void	Free (TAllocator &allocator)
std::size_t	Hashcode () const
std::size_t	HashcodeIgnoreCase () const
template<typename TCheck = CHK, lang::Case TSensitivity = lang::Case::Sensitive>
integer	IndexOf (const TString &needle, integer startIdx=0, integer endIdx=strings::MAX_LEN) const
template<typename TCheck = CHK>
integer	IndexOf (TChar needle, integer regionStart, integer regionLength) const
template<typename TCheck = CHK>
integer	IndexOf (TChar needle, integer startIdx=0) const
template<lang::Inclusion TInclusion, typename TCheck = CHK>
integer	IndexOfAny (const TString &needles, integer startIdx=0) const
template<typename TCheck = CHK>
integer	IndexOfFirstDifference (const TString &needle, lang::Case sensitivity=lang::Case::Sensitive, integer startIdx=0) const
integer	IndexOfOrLength (TChar needle) const
template<typename TCheck = CHK>
integer	IndexOfOrLength (TChar needle, integer startIdx) const
integer	IndexOfSegmentEnd (TChar opener, TChar closer, integer idx) const
constexpr bool	IsEmpty () const
constexpr bool	IsNotEmpty () const
constexpr bool	IsNotNull () const
constexpr bool	IsNull () const
template<typename TCheck = CHK>
integer	LastIndexOf (TChar needle, integer startIndex=MAX_LEN) const
template<lang::Inclusion TInclusion, typename TCheck = CHK>
integer	LastIndexOfAny (const TString &needles, integer startIdx=MAX_LEN) const
constexpr integer	Length () const
template<typename T>
constexpr	operator T () const
constexpr TString &	operator= (const TString &) noexcept=default
constexpr TString &	operator= (TString &&) noexcept=default
TChar	operator[] (integer idx) const
uint64_t	ParseBin (integer *newIdx) const
uint64_t	ParseBin (integer startIdx, integer *newIdx) const
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	ParseDec (integer *newIdx) const
uint64_t	ParseDec (integer startIdx, integer *newIdx) const
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	ParseDecDigits (integer startIdx=0, integer *newIdx=nullptr) const
double	ParseFloat (integer *newIdx) const
double	ParseFloat (integer startIdx, integer *newIdx) const
double	ParseFloat (integer startIdx=0, TNumberFormat< TChar > *numberFormat=nullptr, integer *newIdx=nullptr) const
double	ParseFloat (TNumberFormat< TChar > *numberFormat, integer *newIdx=nullptr) const
uint64_t	ParseHex (integer *newIdx) const
uint64_t	ParseHex (integer startIdx, integer *newIdx) const
uint64_t	ParseHex (integer startIdx=0, TNumberFormat< TChar > *numberFormat=nullptr, integer *newIdx=nullptr) const
uint64_t	ParseHex (TNumberFormat< TChar > *numberFormat, integer *newIdx=nullptr) const
int64_t	ParseInt (integer *newIdx) const
int64_t	ParseInt (integer startIdx, integer *newIdx) const
int64_t	ParseInt (integer startIdx=0, TNumberFormat< TChar > *numberFormat=nullptr, integer *newIdx=nullptr) const
int64_t	ParseInt (TNumberFormat< TChar > *numberFormat, integer *newIdx=nullptr) const
uint64_t	ParseOct (integer *newIdx) const
uint64_t	ParseOct (integer startIdx, integer *newIdx) const
uint64_t	ParseOct (integer startIdx=0, TNumberFormat< TChar > *numberFormat=nullptr, integer *newIdx=nullptr) const
uint64_t	ParseOct (TNumberFormat< TChar > *numberFormat, integer *newIdx=nullptr) const
const_reverse_iterator	rbegin () const
const_reverse_iterator	rend () const
size_type	size () const
template<typename TCheck = CHK, lang::Case TSensitivity = lang::Case::Sensitive>
bool	StartsWith (const TString &needle) const
template<typename TCheck = CHK>
TString< TChar >	Substring (integer regionStart, integer regionLength=MAX_LEN) const
integer	WStringLength () const
Public Method Index: inherited from alib::lang::AllocatorMember< TAllocator >
template<typename TIf = TAllocator>
	AllocatorMember ()
	AllocatorMember (TAllocator &pAllocator) noexcept
AllocatorInterface< TAllocator >	AI () const noexcept
TAllocator &	GetAllocator () const noexcept

Additional Inherited Members
Public Type Index: inherited from alib::strings::TAString< TChar, TAllocator >
using	AllocatorType
	Exposes the allocator type specified by template parameter TAllocator.
using	iterator
using	reverse_iterator
	Same as iterator, but working from the end to the start of the string.
Public Type Index: inherited from alib::strings::TString< TChar >
using	const_iterator = TRandomAccessIterator<const TChar>
using	const_reverse_iterator = std::reverse_iterator<const_iterator>
using	size_type = integer
	The type defining sizes of strings.
using	value_type = TChar
	Exposes template parameter TChar to the outer world in a std compatible way.
Public Type Index: inherited from alib::lang::AllocatorMember< TAllocator >
using	AllocatorType = TAllocator
	Exposes the allocator type.
Protected Type Index: inherited from alib::strings::TLocalString< TChar, TCapacity, TAllocator >
using	base
	The base AString-type.
using	sBase
	The base String-type.
Protected Type Index: inherited from alib::strings::TAString< TChar, TAllocator >
using	allocBase
	The type of the base class that stores the allocator.
using	base
	The base string-type.
Protected Field Index: inherited from alib::strings::TLocalString< TChar, TCapacity, TAllocator >
TChar	localBuffer [TCapacity]
Protected Field Index: inherited from alib::strings::TAString< TChar, TAllocator >
integer	capacity
bool	dbgWarnWhenExternalBufferIsReplaced
integer	debugLastAllocRequest
Protected Field Index: inherited from alib::strings::TString< TChar >
const TChar *	buffer
integer	length
Protected Field Index: inherited from alib::lang::AllocatorMember< TAllocator >
TAllocator *	allocator
	The allocator stored.
Protected Method Index: inherited from alib::strings::TAString< TChar, TAllocator >
constexpr	TAString (TAllocator &pAllocator, TChar *extBuffer, integer extBufferSize)
constexpr	TAString (TChar *extBuffer, integer extBufferSize)
Protected Method Index: inherited from alib::strings::TString< TChar >
template<lang::Case TSensitivity = lang::Case::Sensitive>
integer	indexOfString (const TString &needle, integer startIdx, integer endIdx) const

Constructor(s) / Destructor Details:

TLocalStringNoWarning() [1/2]

template<typename TChar, integer TCapacity, typename TAllocator>

alib::strings::TLocalStringNoWarning< TChar, TCapacity, TAllocator >::TLocalStringNoWarning ( )

inlineconstexpr

Default constructor.

Definition at line 273 of file localstring.inl.

TLocalStringNoWarning() [2/2]

template<typename TChar, integer TCapacity, typename TAllocator>

alib::strings::TLocalStringNoWarning< TChar, TCapacity, TAllocator >::TLocalStringNoWarning ( const String & src )

inline

Constructor taking a string to copy.

Parameters

src	The string to copy into this object.

Definition at line 279 of file localstring.inl.

---

The documentation for this struct was generated from the following file:

• localstring.inl