MeVis/Foundation/Sources/DicomTree/MLDicomTree/DCMTree_Value.h

Go to the documentation of this file.

//-----------------------------------------------------------------------------
// **InsertLicense** code
//-----------------------------------------------------------------------------

// values are stored binary internaly, ie.
// there is no implicit conversion taking place.
// data is converted if desired by DCMTree::Tag
//-----------------------------------------------------------------------------

#ifndef CLASS_DCMTREE_VALUE
#define CLASS_DCMTREE_VALUE

#include <vector>

#include <istream>
#include <ostream>

#include "boost/shared_array.hpp"

#include "DCMTree_Lib.h"
#include "DCMTree_Defines.h"


namespace DCMTree
{
    class DCMTREE_EXPORT Value:public DCMTree_Serialization::Serializable,public DCMTree_Serialization::Deserializable
    {
      public:
        enum SetDataMode
        {
          SDM_makeCopy,         // copy the data into the value
          SDM_takeOwnership     // the value takes the ownership of the data
        };

    public:
        Value();

        Value (const unsigned int &size);

        Value (const unsigned int &size,const unsigned char *data);

        Value (const Value &other);

        virtual ~Value();

        Value &operator =(const Value &other);

        bool operator ==(const Value &other) const;

        bool operator !=(const Value &other) const;

        void purge();

        unsigned int size() const;

        const unsigned char *data() const;

        unsigned char *data();

        boost::shared_array<unsigned char> sharedData() const;

        void setSize (const unsigned int &size);

        void setData (const unsigned int &size,const unsigned char *data);

        void setData (const unsigned int &size, unsigned char *data,
                      SetDataMode setDataMode = SDM_makeCopy);

        void setData (const std::string &value);

        bool isNull() const;

        void fromStream (std::istream &in);

        void toStream (std::ostream &out) const;

        void serializeX (DCMTree_Serialization::Sink &sink) const;
        void deserializeX (DCMTree_Serialization::Source &source);

    private:
        void allocate (const unsigned int &size);

        boost::shared_array<unsigned char> _data;
        unsigned int _size;
        unsigned int _buffersize;
    };

    typedef std::vector<Value> ValueVector;

    inline std::ostream &operator << (std::ostream &out,const Value &v)
    {
        v.toStream (out);
        return out;
    }

    inline std::istream &operator >> (std::istream &in,Value &v)
    {
        v.fromStream (in);
        return in;
    }
}

#endif