//----------------------------------------------------------------------------
//
// TSDuck - The MPEG Transport Stream Toolkit
// Copyright (c) 2005-2026, Thierry Lelegard
// BSD-2-Clause license, see LICENSE.txt file or https://tsduck.io/license
//
//----------------------------------------------------------------------------
//!
//!  @file
//!  Analysis (deserialization) of TLV messages.
//!
//----------------------------------------------------------------------------

#pragma once
#include "tstlv.h"

namespace ts::tlv {
    //!
    //! Analysis (deserialization) of TLV messages.
    //! @ingroup libtscore tlv
    //!
    class TSCOREDLL Analyzer
    {
        TS_NOBUILD_NOCOPY(Analyzer);
    public:
        //!
        //! Constructor.
        //! Associate the analyzer object with the address and size of the
        //! binary message. The corresponding memory area must remain alive
        //! as long as the object exists. Also pre-analyze the first TLV field.
        //! @param [in] addr Address of the binary message.
        //! @param [in] size Size in bytes of the binary message.
        //!
        Analyzer(const void* addr, size_t size);

        //!
        //! Check if the end of message has been reached.
        //! @return True if the end of message has been reached.
        //!
        bool endOfMessage() const { return _eom; }

        //!
        //! Check if the rest of the message is valid.
        //! When valid() becomes false, endOfMessage() also become false.
        //! @return True if the rest of the message is valid.
        //!
        bool valid() const { return _valid; }

        //!
        //! Get the address of the current TLV field.
        //! @return Address of the current TLV field.
        //!
        const void* fieldAddr() const { return _tlv_addr; }

        //!
        //! Get the complete size of the current TLV field.
        //! @return Complete size of the current TLV field.
        //!
        size_t fieldSize() const { return _tlv_size; }

        //!
        //! Get the tag of the current TLV field.
        //! @return Tag of the current TLV field.
        //!
        TAG tag() const { return _tag; }

        //!
        //! Get the address of the value field in the current TLV field.
        //! @return The address of the value field in the current TLV field.
        //!
        const void* valueAddr() const { return _value_addr; }

        //!
        //! Get the length of the value field in the current TLV field.
        //! @return The length of the value field in the current TLV field.
        //!
        LENGTH length() const { return _length; }

        //!
        //! Analyze the next TLV field.
        //!
        void next();

    private:
        // Private members
        const char* _base = nullptr;        // start of global message
        const char* _end = nullptr;         // end of global message
        bool        _eom = true;            // end of message
        bool        _valid = false;         // TLV structure is valid
        const char* _tlv_addr = nullptr;    // address of current TLV field
        size_t      _tlv_size = 0;          // size of current TLV field
        TAG         _tag = 0;               // tag of current TLV field
        const char* _value_addr = nullptr;  // address of value in current TLV field
        LENGTH      _length = 0;            // length of current TLV field
    };
}
