alib::boxing::compatibility::std Namespace Reference

Description:

This namespace documents compatibility features of ALib Boxing and the standard C++ class library found in namespace std.

Type Index:
struct	equal_to< alib::boxing::Box >
struct	equal_to< alib::boxing::Enum >
struct	hash< alib::boxing::Box >
struct	hash< alib::boxing::Enum >
struct	less< alib::boxing::Box >
struct	less< alib::boxing::Enum >
struct	T_Boxer< std::array< TElement, N >, ATMP_VOID_IF(!characters::TT_IsChar< TElement >::value) >
struct	T_Boxer< std::vector< TElement >, ATMP_VOID_IF(!characters::TT_IsChar< TElement >::value) >

Function Index:
void	BootstrapStdStringBoxing ()
template<typename TElement >
void	CopyToVector (::std::vector< TElement > &target, const Box &box)

Function Details:

BootstrapStdStringBoxing()

void BootstrapStdStringBoxing ( )

inline

Initializes ALib Boxing in respect to std::string-types.

This method is not automatically invoked with function Bootstrap, because support for boxing std::string-types is optional and provided with the inclusion of header alib/compatibility/std_boxing.hpp.

In general boxing of std::string-types works well without the one-time invocation of this function at the bootstrap of a process. This method registers box-function FAppend for std::string-types types when custom boxing is bypassed by wrapping the types in std::reference_wrapper<T>. The function is implemented with the help of FAppend::WrappedAppendable for wrapped std::string-types, each for character types nchar and wchar.

Note

If invoked after bootstrap and modules ALib Threads and ALib Monomem are included in the ALib Distribution, mutex GLOBAL_ALLOCATOR_LOCK has to be locked before an invocation. Bootstrapping may look as follows:

{
    ALIB_LOCK_RECURSIVE_WITH( monomem::GLOBAL_ALLOCATOR_LOCK )
    alib::boxing::compatibility::std::BootstrapStdStringBoxing();
}    

(Note, that the curly brackets create a compound that release the automatic owner instance after the call.)
Alternatively, bootstrapping can be performed until BootstrapPhases::PrepareConfig and then this function can be invoked. In this case, no locking is necessary.

Definition at line 177 of file std_boxing.hpp.

Here is the call graph for this function:

CopyToVector()

template<typename TElement >

void CopyToVector ( ::std::vector< TElement > & target, const Box & box )

inline

Creates a deep copy of a boxed C++ array type by appending its contents to a given std::vector of corresponding element type.
Note that no type checks are performed on the given box.

Template Parameters

TElement

The element type.

Parameters

target	The target vector to fill.
box	The source box of type TElement[].

Definition at line 138 of file std_boxing.hpp.

Here is the call graph for this function: