Format.h

Go to the documentation of this file.

/*
 * Copyright (C) 1996-2025 The Squid Software Foundation and contributors
 *
 * Squid software is distributed under GPLv2+ license and includes
 * contributions from numerous individuals and organizations.
 * Please see the COPYING and CONTRIBUTORS files for details.
 */
 
#ifndef SQUID_SRC_FORMAT_FORMAT_H
#define SQUID_SRC_FORMAT_FORMAT_H
 
#include "base/RefCount.h"
#include "ConfigParser.h"
#include "sbuf/SBuf.h"
 
/*
 * Squid configuration allows users to define custom formats in
 * several components.
 * - logging
 * - external ACL input
 * - deny page URL
 *
 * These enumerations and classes define the API for parsing of
 * format directives to define these patterns. Along with output
 * functionality to produce formatted buffers.
 */
 
class AccessLogEntry;
typedef RefCount<AccessLogEntry> AccessLogEntryPointer;
class MemBuf;
class StoreEntry;
 
namespace Format
{
 
extern const SBuf Dash;
 
class Token;
 
// XXX: inherit from linked list
class Format
{
public:
    Format(const char *name);
    virtual ~Format();
 
    /* very inefficient parser, but who cares, this needs to be simple */
    /* First off, let's tokenize, we'll optimize in a second pass.
     * A token can either be a %-prefixed sequence (usually a dynamic
     * token but it can be an escaped sequence), or a string. */
    bool parse(const char *def);
 
    void assemble(MemBuf &mb, const AccessLogEntryPointer &al, int logSequenceNumber) const;
 
    void dump(StoreEntry * entry, const char *directiveName, bool eol = true) const;
 
    char *name;
    Token *format;
    Format *next;
};
 
size_t AssembleOne(const char *start, MemBuf &buf, const AccessLogEntryPointer &ale);
 
} // namespace Format
 
#endif /* SQUID_SRC_FORMAT_FORMAT_H */