message.hpp

Go to the documentation of this file.

//==================================================================================================
/// \file
/// This header-file is part of module \alib_exceptions of the \aliblong.
///
/// Copyright 2013-2026 A-Worx GmbH, Germany.
/// Published under #"mainpage_license".
//==================================================================================================
ALIB_EXPORT namespace alib::exceptions {
 
//==================================================================================================
/// This struct stores a list of information objects of arbitrary types, by publicly inheriting type
/// #"BoxesMA;2".
/// In addition, the #"CallerInfo" is attached, which usually refers to the place
/// (and thread) tat constructed an instance of this type.<br>
/// Finally, a type identifier is available with field #".Type".
///
/// Note that while message data might be passed with construction, informational data may be added,
/// changed or removed during the life-cycle of an instance using the inherited interface of
/// class #"TBoxes".
///
/// Inside \alib, the struct is used with the type #"exc Exception".
//==================================================================================================
struct Message : BoxesMA {
    CallerInfo  CI;       ///< The source code location that this message relates to.
    Enum        Type;     ///< A type identifier, defined with construction by providing an element
                          ///< of an arbitrary enumeration type.
    /// Constructor.
    /// @param ci                 Information about the scope of invocation.
    /// @param monoAllocator      The allocator to store the arguments in.
    /// @param type               The message type.
    /// @param args               Variadic, templated list of arguments.
    template <typename... TBoxables>
    Message( const CallerInfo&     ci,
             MonoAllocator&        monoAllocator,
             const Enum&           type,
             TBoxables&&...        args )
    : TBoxes( monoAllocator )
    , CI  (ci)
    , Type(type)                                        { Add( std::forward<TBoxables>(args)... ); }
};
 
} // namespace [alib::exceptions]
 
// Customize boxing of type Message to its parent type Boxes. This allows "flattening" all
// arguments stored in a message when added to an instance of Boxes.
ALIB_BOXING_CUSTOMIZE_TYPE_MAPPING( alib::exceptions::Message*, boxing::TBoxes<MonoAllocator>* )