XLStreamReader.hpp

Go to the documentation of this file.

#ifndef OPENXLSX_XLSTREAMREADER_HPP
#define OPENXLSX_XLSTREAMREADER_HPP
 
#include "OpenXLSX-Exports.hpp"
#include "XLCellValue.hpp"
#include <cstdint>
#include <string>
#include <vector>
 
namespace OpenXLSX
{
 
    class XLWorksheet;
 
    class OPENXLSX_EXPORT XLStreamReader
    {
    public:
        XLStreamReader()                                 = default;
        XLStreamReader(const XLStreamReader&)            = delete;
        XLStreamReader& operator=(const XLStreamReader&) = delete;
 
        XLStreamReader(XLStreamReader&& other) noexcept;
        XLStreamReader& operator=(XLStreamReader&& other) noexcept;
 
        ~XLStreamReader();
 
        bool hasNext();
 
        std::vector<XLCellValue> nextRow();
 
        uint32_t currentRow() const;
 
        void close();
 
    private:
        friend class XLWorksheet;
 
        explicit XLStreamReader(const XLWorksheet* worksheet);
 
        void fetchMoreData();
 
        enum class SaxState : uint8_t {
            Scanning,         // Scanning for an opening '<'
            InTagName,        // Reading the tag name
            InAttrName,       // Reading an attribute name
            AfterAttrName,    // After attr name, waiting for '='
            InAttrValue,      // Reading an attribute value (inside quotes)
            InTextContent,    // Inside a tag's text content (e.g., <v>42</v>)
            InClosingTag,     // Reading a closing tag (after '</')
        };
 
        void cleanup();
 
        const XLWorksheet* m_worksheet{nullptr};
        void*              m_zipStream{nullptr};
 
        std::string m_buffer;
        bool        m_eof{false};
        uint32_t    m_currentRow{0};
 
        // Reusable scratch buffers to avoid per-row heap allocation
        std::string m_tagNameBuf;
        std::string m_attrNameBuf;
        std::string m_attrValueBuf;
        std::string m_textContentBuf;
    };
 
}    // namespace OpenXLSX
#endif    // OPENXLSX_XLSTREAMREADER_HPP