Description:

template<typename TAppendable, typename TChar, typename TAllocator>
struct alib::strings::AppendableTraits< TAppendable, TChar, TAllocator >

This is a type-traits functor that allows making custom types "appendable" to objects of type AString.

Specializations of this struct have to implement operator(), which is invoked by method AString::Append, when an instance of the type in question is passed.

For user-defined string-types that get adopted to ALib string system using a specialization of struct ArrayTraits, no specialization of this functor is needed, because the method AString::Append will accept such types likewise.

Note: This struct is called a "functor" because its single member is operator(). This is different to other type traits defined by ALib, which demand to implement one or more static methods with specializations. As operator() must not be static, the internal call to this operator is done by creating a temporary object of this "functor struct" and calling the operator on that.
The result in respect to the generated code is with both approaches the same. Using a functor here, is just a design decision.

See also: For details consult chapter 5.1 Appending Custom Types of the Programmer's Manual of module ALib Strings.; The documentation of built-in specializations for ALib types are collected in sub-namespace alib::strings::APPENDABLES.

Reference Documentation

Template Parameters

TAppendable	The type that should be made compatible with method Append(const TAppendable&).
TChar	The character type of the target AString.
TAllocator	The allocator type of the target AString.

Definition at line 51 of file tastring.inl.

Public Method Index:
void	operator() (TAString< TChar > &target, const TAppendable &src)

Method Details:

◆ operator()()

template<typename TAppendable, typename TChar, typename TAllocator>

template ALIB_DLL void alib::strings::APPENDABLES::strings::AppendableTraits::operator()	(	TAString< TChar > &	target,
		const TAppendable &	src )

This operator is invoked on a temporary object of this type by TAString::Append(const TAppendable&), when an object of type TAppendable is passed.

Usually, specializations of this operator append a string representation of src to target. Special "appendable types" might modify target in other, arbitrary ways.

Parameters

target	The target string.
src	The source object.

Definition at line 449 of file tastringimpl.inl.

Here is the call graph for this function:

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

Description:

Reference Documentation

Public Method Index:

Method Details:

◆ operator()()