Buffer.hpp

Go to the documentation of this file.

// ======================================================================
// \title  Buffer.hpp
// \author mstarch
// \brief  hpp file for Fw::Buffer definition
//
// \copyright
// Copyright 2009-2020, by the California Institute of Technology.
// ALL RIGHTS RESERVED.  United States Government Sponsorship
// acknowledged.
//
// ======================================================================
#ifndef BUFFER_HPP_
#define BUFFER_HPP_

#include <FpConfig.hpp>
#include <Fw/Types/Serializable.hpp>
#if FW_SERIALIZABLE_TO_STRING
    #include <Fw/Types/StringType.hpp>
    #ifdef BUILD_UT
        #include <iostream>
        #include <Fw/Types/String.hpp>
    #endif
#endif

namespace Fw {

class Buffer : public Fw::Serializable {

public:

    enum {
        SERIALIZED_SIZE = sizeof(U32) + sizeof(U32) + sizeof(U8*), 
        NO_CONTEXT = 0xFFFFFFFF 
    };

    Buffer();

    Buffer(const Buffer& src);

    Buffer(U8* data, U32 size, U32 context=NO_CONTEXT);

    Buffer& operator=(const Buffer& src);

    bool operator==(const Buffer& src) const;

    // ----------------------------------------------------------------------
    // Serialization functions
    // ----------------------------------------------------------------------

    SerializeBufferBase& getSerializeRepr();

    Fw::SerializeStatus serialize(Fw::SerializeBufferBase& serialBuffer) const;

    Fw::SerializeStatus deserialize(Fw::SerializeBufferBase& buffer);


    // ----------------------------------------------------------------------
    // Accessor functions
    // ----------------------------------------------------------------------

    bool isValid() const;

    U8* getData() const;

    U32 getSize() const;

    U32 getContext() const;

    void setData(U8* data);

    void setSize(U32 size);

    void setContext(U32 context);

    void set(U8* data, U32 size, U32 context=NO_CONTEXT);

#if FW_SERIALIZABLE_TO_STRING || BUILD_UT
    void toString(Fw::StringBase& text) const;
#endif

#ifdef BUILD_UT
    friend std::ostream& operator<<(std::ostream& os, const Buffer& obj);
#endif

PRIVATE:
    Fw::ExternalSerializeBuffer m_serialize_repr; //<! Representation for serialization and deserialization functions
    U8* m_bufferData; //<! data - A pointer to the data
    U32 m_size; //<! size - The data size in bytes
    U32 m_context; 

};
} // end namespace Fw
#endif /* BUFFER_HPP_ */