/*
* Copyright (C) 2025 Linux Studio Plugins Project
* (C) 2025 Vladimir Sadovnikov
*
* This file is part of lsp-runtime-lib
* Created on: 29 янв. 2023 г.
*
* lsp-runtime-lib is free software: you can redistribute it and/or modify
* it under the terms of the GNU Lesser General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* any later version.
*
* lsp-runtime-lib 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 Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with lsp-runtime-lib. If not, see .
*/
#ifndef LSP_PLUG_IN_FMT_SFZ_PULLPARSER_H_
#define LSP_PLUG_IN_FMT_SFZ_PULLPARSER_H_
#include
#include
#include
#include
#include
#include
namespace lsp
{
namespace sfz
{
/**
* SFZ file format pull parser
*/
class LSP_RUNTIME_LIB_PUBLIC PullParser
{
private:
io::IInStream *pIn;
size_t nWFlags;
event_t sCurrent;
event_t sSample; // Pending sample event
LSPString sUnget; // Buffer for 'unget' operations
size_t nUnget; // Read offset relative to the beginning of the 'unget' buffer
protected:
static bool is_identifier(lsp_wchar_t ch, bool first);
static bool is_space(lsp_wchar_t ch);
static void trim_right(LSPString *value);
static bool is_string_opcode(const LSPString *name);
protected:
lsp_swchar_t get_char();
status_t expect_string(const char *text);
status_t expect_char(lsp_swchar_t expected);
status_t read_opcode(lsp_wchar_t ch, event_t *ev);
status_t read_opcode_name(lsp_swchar_t ch, LSPString *name);
status_t read_opcode_value(LSPString *value);
status_t read_string_opcode(LSPString *value);
status_t read_variable_name(LSPString *value);
status_t read_variable_value(LSPString *value);
status_t read_sample_data(io::IOutStream *os);
status_t peek_pending_event(event_t *ev);
status_t read_next_event(event_t *ev);
status_t read_header(event_t *ev);
status_t read_comment(event_t *ev);
status_t read_define(event_t *ev);
status_t read_include(event_t *ev);
status_t read_preprocessor(event_t *ev);
status_t set_error(status_t code);
public:
explicit PullParser();
PullParser(const PullParser &) = delete;
PullParser(PullParser &&) = delete;
~PullParser();
PullParser & operator = (const PullParser &) = delete;
PullParser & operator = (PullParser &&) = delete;
public:
/**
* Open parser
* @param path UTF-8 path to the file
* @return status of operation
*/
status_t open(const char *path);
/**
* Open parser
* @param path string representation of path to the file
* @return status of operation
*/
status_t open(const LSPString *path);
/**
* Open parser
* @param path path to the file
* @return status of operation
*/
status_t open(const io::Path *path);
/**
* Wrap string with parser
* @param str string to wrap
* @return status of operation
*/
status_t wrap(const char *str);
/**
* Wrap string with parser
* @param buf buffer to wrap
* @param len length of buffer to wrap
* @return status of operation
*/
status_t wrap(const void *buf, size_t len);
/**
* Wrap string with parser
* @param str string to wrap
* @return status of operation
*/
status_t wrap(const LSPString *str);
/**
* Wrap input stream with parser
* @param is input stream
* @param flags wrap flags
* @return status of operation
*/
status_t wrap(io::IInStream *is, size_t flags = WRAP_NONE);
/**
* Close parser
* @return status of operation
*/
status_t close();
public:
/**
* Get current event
* @return current event
*/
const event_t *current() const;
/**
* Get next event
* @param event pointer to store the event data, can be NULL
* @return status of operation
*/
status_t next(event_t *event = NULL);
};
} /* namespace sfz */
} /* namespace lsp */
#endif /* LSP_PLUG_IN_FMT_SFZ_PULLPARSER_H_ */