ParsingBuffer.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_STORE_PARSINGBUFFER_H
#define SQUID_SRC_STORE_PARSINGBUFFER_H
 
#include "sbuf/SBuf.h"
#include "StoreIOBuffer.h"
 
#include <optional>
 
namespace Store
{
 
class ParsingBuffer
{
public:
    ParsingBuffer() = default;
 
    explicit ParsingBuffer(StoreIOBuffer &);
 
    const char *c_str() { terminate(); return memory(); }
 
    SBuf toSBuf() const;
 
    size_t contentSize() const;
 
    size_t spaceSize() const;
 
    size_t capacity() const;
 
    StoreIOBuffer content() const;
 
    StoreIOBuffer space();
 
    StoreIOBuffer makeSpace(size_t pageSize);
 
    StoreIOBuffer makeInitialSpace() { return makeSpace(4096); }
 
    void appended(const char *, size_t);
 
    void consume(size_t);
 
    StoreIOBuffer packBack();
 
    void print(std::ostream &) const;
 
private:
    const char *memory() const;
    void terminate();
    void growSpace(size_t);
 
private:
    StoreIOBuffer readerSuppliedMemory_;
 
    size_t readerSuppliedMemoryContentSize_ = 0;
 
    std::optional<SBuf> extraMemory_;
};
 
inline std::ostream &
operator <<(std::ostream &os, const ParsingBuffer &b)
{
    b.print(os);
    return os;
}
 
} // namespace Store
 
#endif /* SQUID_SRC_STORE_PARSINGBUFFER_H */