propertyformatter.cpp

// #################################################################################################
//  ALib C++ Library
//
//  Copyright 2013-2025 A-Worx GmbH, Germany
//  Published under 'Boost Software License' (a free software license, see LICENSE.txt)
// #################################################################################################
#include "alib_precompile.hpp"
#if !defined(ALIB_C20_MODULES) || ((ALIB_C20_MODULES != 0) && (ALIB_C20_MODULES != 1))
#   error "Symbol ALIB_C20_MODULES has to be given to the compiler as either 0 or 1"
#endif
#if ALIB_C20_MODULES
    module;
#endif
// ======================================   Global Fragment   ======================================
#include <vector>
#include "alib/alib.inl"
// ===========================================   Module   ==========================================
#if ALIB_C20_MODULES
    module ALib.Format.PropertyFormatter;
    import   ALib.Lang;
    import   ALib.Strings;
    import   ALib.Exceptions;
#   if ALIB_CAMP
      import ALib.Camp.Base;
#   endif
#else
#   include "ALib.Lang.H"
#   include "ALib.Strings.H"
#   include "ALib.Exceptions.H"
#   include "ALib.Format.PropertyFormatter.H"
#   include "ALib.Camp.Base.H"
#endif
// ======================================   Implementation   =======================================
namespace alib::format {
 
PropertyFormatter::PropertyFormatter( const String             customFormatString,
                                      const TCallbackTable&    propertyTable,
                                      SPFormatter              formatter,
                                      character                ESCCharacter          )
: stdFormatter        ( formatter )
, propertyFormatString( customFormatString )
, formatString        ( customFormatString )
{
    if(!formatter.Get())
        stdFormatter= Formatter::Default;
 
    integer parsePos= 0;
    while(parsePos < formatString.Length() )
    {
        // find next parse position
        integer parsePosCopy= parsePos;
        if( (parsePos= formatString.IndexOf( ESCCharacter, parsePosCopy ) ) < 0 )
            break;
 
        String identifier;
        integer endPos= parsePos+ 1;
        if( endPos < formatString.Length() )
        {
            // double Escape character? -> replace to single!
            if( formatString[endPos] == ESCCharacter )
            {
                formatString.Delete( endPos, 1 );
                ++parsePos;
                continue;
            }
 
            // find end of Identifier
            while( endPos < formatString.Length()  && isalpha( formatString[endPos] ) )
                ++endPos;
 
            identifier= formatString.Substring<NC>( parsePos + 1, endPos - parsePos - 1 );
        }
 
        // not found
        if( identifier.IsEmpty() )
            continue;
 
        // add callback
        auto entryIt= propertyTable.begin();
        while( entryIt != propertyTable.end() )
        {
            if( Substring(identifier).ConsumePartOf<lang::Case::Ignore>( entryIt->Name,
                                                                         entryIt->MinimumRecognitionLength
                                                                       ) == identifier.Length() )
            {
                // remove identifier from format string
                formatString.Delete( parsePos, endPos - parsePos + (formatString[endPos] == ESCCharacter ? 1 : 0) );
 
                // store callback
                callBacks.emplace_back( &*entryIt );
                ++parsePos;
                break;
            }
            ++entryIt;
        }
 
        // identifier not found?
        if( entryIt == propertyTable.end() )
        {
            Exception e( ALIB_CALLER_NULLED, FMTExceptions::UnknownPropertyInFormatString,
                         ESCCharacter, identifier, customFormatString  );
            for( auto& row : propertyTable )
               e.Back().Add( ESCCharacter, row.Name, ", " );
            e.Back().back()= '.'; // replace the last comma
 
            throw e;
        }
    }
}
 
 
void    PropertyFormatter::Format( AString& target, const Box&  src )
{
    // string buffers
    std::vector<String> heapStrings;
    String128   localString;
    localString.DbgDisableBufferReplacementWarning();
 
    // collect boxes
    BoxesMA& results= stdFormatter->GetArgContainer();
    results.Add( formatString );
    for( auto& entry : callBacks )
    {
        Box argument= entry->Callback( src, localString );
        if( localString.IsNotEmpty() )
        {
            heapStrings.emplace_back( localString );
            argument= heapStrings.back();
        }
 
        results.Add ( argument  );
        localString.Reset();
    }
 
    // invoke ALib default formatter
    try
    {
        stdFormatter->FormatArgs( target, results );
    }
    catch(Exception& e)
    {
        e.Add( ALIB_CALLER_NULLED, FMTExceptions::ErrorInResultingFormatString, propertyFormatString );
        throw;
    }
 
    results.clear();
}
 
 
} // namespace [alib::format]