Parser.h

Go to the documentation of this file.

/****
 * Parser.h
 *
 * Copyright 2021 mikee47 <mike@sillyhouse.net>
 *
 * This file is part of the CsvReader Library
 *
 * This library is free software: you can redistribute it and/or modify it under the terms of the
 * GNU General Public License as published by the Free Software Foundation, version 3 or later.
 *
 * This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
 * without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
 * See the GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License along with this library.
 * If not, see <https://www.gnu.org/licenses/>.
 *
 ****/
 
#pragma once
 
#include <Delegate.h>
#include <Data/CStringArray.h>
#include <Data/Stream/DataSourceStream.h>
 
namespace CSV
{
struct Cursor {
    int start;  
    unsigned end; 
 
    size_t length() const
    {
        return (start < 0) ? 0 : end - unsigned(start);
    }
 
    operator String() const
    {
        String s;
        s += '[';
        s += start;
        s += ',';
        s += length();
        s += ']';
        return s;
    }
};
 
class Parser
{
public:
    struct Options {
        const char* commentChars = nullptr;
        uint16_t lineLength = 256;
        char fieldSeparator = ',';
        bool parseEscape = false;
        bool wantComments = false;
    };
 
    static constexpr int BOF{-1}; 
 
    Parser(const Options& options) : options(options)
    {
    }
 
    bool push(Stream& source);
 
    bool push(const char* data, size_t length, size_t& offset);
 
    bool flush();
 
    bool readRow(IDataSourceStream& source);
 
    void reset(int offset = BOF);
 
    const CStringArray& getRow() const
    {
        return row;
    }
 
    int tell() const
    {
        return cursor.start;
    }
 
    const Cursor& getCursor() const
    {
        return cursor;
    }
 
    unsigned getStreamPos() const
    {
        return sourcePos - taillen;
    }
 
    const Options& getOptions() const
    {
        return options;
    }
 
private:
    size_t fillBuffer(Stream* source);
    bool parseRow(bool eof);
 
    Options options;
    CStringArray row;
    String buffer;
    Cursor cursor{BOF}; 
    unsigned sourcePos{0}; 
    uint16_t tailpos{0};
    uint16_t taillen{0};
};
 
} // namespace CSV