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 <Fw/FPrimeBasicTypes.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:

    using SizeType = U32;

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

    Buffer();

    Buffer(const Buffer& src);

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

    Buffer& operator=(const Buffer& src);

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

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

    DEPRECATED(SerializeBufferBase& getSerializeRepr(), "Switch to .getSerializer() and .getDeserializer()");

    ExternalSerializeBufferWithMemberCopy getSerializer();


    ExternalSerializeBufferWithMemberCopy getDeserializer();

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

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


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

    bool isValid() const;

    U8* getData() const;

    SizeType getSize() const;

    U32 getContext() const;

    void setData(U8* data);

    void setSize(SizeType size);

    void setContext(SizeType context);

    void set(U8* data, SizeType 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
    SizeType m_size; //<! size - The data size in bytes
    U32 m_context; 

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