summaryrefslogtreecommitdiff
path: root/libcult/cult/mm/buffer.hxx
blob: d50c824af8cbb02113c576a0f690092f0ebb5ef9 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
// file      : cult/mm/buffer.hxx
// author    : Boris Kolpackov <boris@kolpackov.net>
// copyright : Copyright (c) 2005-2010 Boris Kolpackov
// license   : GNU GPL v2 + exceptions; see accompanying LICENSE file

#ifndef CULT_MM_BUFFER_HXX
#define CULT_MM_BUFFER_HXX

#include <cult/types/fundamental.hxx>

#include <cult/mm/exception.hxx>

namespace Cult
{
  namespace MM
  {
    //@@ why can't capacity be zero?
    //

    class Buffer
    {
    public:
      struct Bounds: virtual Exception {};
      struct ZeroCapacity: virtual Exception {};

    public:
      virtual
      ~Buffer ();

      Buffer (Size capacity, Size size = 0)
        throw (ZeroCapacity, Bounds, BadAlloc);

      Buffer (Void const*, Size size);

      Buffer (Buffer const& other);

    private:
      Buffer&
      operator= (Buffer const&);

    public:
      Size
      capacity () const throw ();

      // Returns true if the underlying buffer has been moved.
      //
      Boolean
      capacity (Size capacity) throw (ZeroCapacity, Bounds, BadAlloc);

    public:
      Size
      size () const throw ();

      Void
      size (Size size) throw (Bounds);

    public:
      Index
      position () const throw ();

      Void
      position (Index) throw (Bounds);

    public:
      Char const*
      data () const;

      Char*
      data ();

    private:
      Void* b_;
      Size c_, s_, p_;
    };
  }

  using MM::Buffer;
}

#endif  // CULT_MM_BUFFER_HXX