/*
 * SPDX-FileCopyrightText: 2000-2002 Copyright LifeLine Networks BV (www.lifeline.nl)
 * SPDX-FileCopyrightText: 2000-2002 Copyright Bastiaan Bakker
 * SPDX-FileCopyrightText: 2004 Copyright contributors to the cppTango project
 *
 * SPDX-License-Identifier: LGPL-3.0-or-later
 */

#ifndef TANGO_COMMON_LOG4TANGO_PATTERNLAYOUT_H
#define TANGO_COMMON_LOG4TANGO_PATTERNLAYOUT_H

#include <tango/common/log4tango/Layout.h>
#include <tango/common/log4tango/Portability.h>

#include <sstream>
#include <vector>

namespace log4tango
{

//-----------------------------------------------------------------------------
// class : PatternLayout (a simple fixed format Layout implementation)
//-----------------------------------------------------------------------------
class PatternLayout : public Layout
{
  public:
    /**
    A conversion pattern equivalent to the BasicLayout.
    **/
    static const char *BASIC_CONVERSION_PATTERN;

    PatternLayout();

    ~PatternLayout() override;

    // NOTE:
    // All double percentage signs ('%%') followed by a character
    // in the following comments should actually be a single char.
    // The doubles are included so that doxygen will print them correctly.

    /**
     * Formats the LoggingEvent in the style set by
     * the set_conversion_pattern call. By default, set
     * to "%%m%%n"
     **/
    std::string format(const LoggingEvent &event) override;

    /**
     * Sets the format of log lines handled by this
     * PatternLayout. By default, set to "%%m%%n".<br>
     * Format characters are as follows:<br>
     * <ul>
     * <li><b>%%%%</b> - a single percent sign</li>
     * <li><b>%%c</b> - the logger</li>
     * <li><b>%%d</b> - the date\n
     *  Date format: The date format character may be followed by a date format
     *  specifier enclosed between braces. For example, %%d{%%H:%%M:%%S,%%l} or %%d{%%d %%m %%Y %%H:%%M:%%S,%%l}.
     *  If no date format specifier is given then the following format is used:
     *  "Wed Jan 02 02:03:55 1980". The date format specifier admits the same syntax
     *  as the ANSI C function strftime, with 1 addition. The addition is the specifier
     *  %%l for microseconds, padded with zeros to make 6 digits.</li>
     * <li><b>%%m</b> - the message</li>
     * <li><b>%%n</b> - the platform specific line separator</li>
     * <li><b>%%p</b> - the level</li>
     * <li><b>%%r</b> - milliseconds since this layout was created.</li>
     * <li><b>%%R</b> - seconds since Jan 1, 1970</li>
     * <li><b>%%u</b> - clock ticks since process start</li>
     * <li><b>%%x</b> - the NDC</li>
     * <li><b>%%F</b> - the file name where the logging request was issued</li>
     * <li><b>%%L</b> - the line number from where the logging request was issued</li>
     * <li><b>%%T</b> - the thread name where the logging request was issued</li>
     * <li><b>%%t</b> - the thread id where the logging request was issued</li>
     * </ul>
     * @param conversionPattern the conversion pattern
     * @exception ConfigureFailure if the pattern is invalid
     **/
    virtual int set_conversion_pattern(const std::string &conversionPattern);

    virtual std::string get_conversion_pattern() const;

    virtual void clear_conversion_pattern();

    class PatternComponent
    {
      public:
        virtual ~PatternComponent() { }

        virtual void append(std::ostringstream &out, const LoggingEvent &event) = 0;
    };

  private:
    typedef std::vector<PatternComponent *> ComponentVector;
    ComponentVector _components;
    std::string _conversionPattern;
};

} // namespace log4tango

#endif // TANGO_COMMON_LOG4TANGO_PATTERNLAYOUT_H
