DCMTree_Value.h

Go to the documentation of this file.

/*************************************************************************************
**
** Copyright 2007, MeVis Medical Solutions AG
**
** The user may use this file in accordance with the license agreement provided with
** the Software or, alternatively, in accordance with the terms contained in a
** written agreement between the user and MeVis Medical Solutions AG.
**
** For further information use the contact form at https://www.mevislab.de/contact
**
**************************************************************************************/
 
// values are stored binary internaly, ie.
// there is no implicit conversion taking place.
// data is converted if desired by DCMTree::Tag
 
#ifndef DCM_TREE_VALUE_H
#define DCM_TREE_VALUE_H
 
#ifdef _MSC_VER
  #pragma warning (push)
  #pragma warning (disable : 4350)
#endif
 
#include <vector>
 
#include <istream>
#include <ostream>
 
#include <boost/shared_array.hpp>
 
#ifdef _MSC_VER
  #pragma warning (pop)
#endif
 
 
#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);
 
        Value(Value &&) noexcept = default;
        Value& operator =(Value &&other) noexcept = default;
 
        ~Value() override;
 
        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 override;
        void deserializeX (DCMTree_Serialization::Source &source) override;
 
    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