buffer.hpp

Go to the documentation of this file.

#pragma once
/*
**  Copyright (C) 2012 Aldebaran Robotics
**  See COPYING for the license
*/

#ifndef _QI_BUFFER_HPP_
#define _QI_BUFFER_HPP_

# include <qi/api.hpp>
# include <qi/types.hpp>
# include <boost/shared_ptr.hpp>
# include <vector>
# include <cstddef>

#ifdef _MSC_VER
#  pragma warning( push )
#  pragma warning( disable: 4251 )
#endif

namespace qi
{
  class BufferPrivate;

  class QI_API Buffer
  {
  public:
    Buffer();
    Buffer(const Buffer& b);
    Buffer& operator = (const Buffer& b);

    bool write(const void *data, size_t size);

    size_t addSubBuffer(const Buffer& buffer);
    bool   hasSubBuffer(size_t offset) const;
    const  Buffer& subBuffer(size_t offset) const;

    size_t size() const;
    size_t totalSize() const;

    const std::vector<std::pair<size_t, Buffer> >& subBuffers() const;

    void* reserve(size_t size);
    void  clear();

    void* data();
    const void* data() const;

    const void* read(size_t offset = 0, size_t length = 0) const;
    size_t read(void* buffer, size_t offset = 0, size_t length = 0) const;

  private:
    friend class BufferReader;
    // CS4251
    boost::shared_ptr<BufferPrivate> _p;
  };

  namespace details {
    QI_API void printBuffer(std::ostream& stream, const Buffer& buffer);
  }
}

#ifdef _MSC_VER
#  pragma warning( pop )
#endif

#endif  // _QI_BUFFER_HPP_