summaryrefslogtreecommitdiff
path: root/libs/asio/doc/requirements/ConvertibleToMutableBuffer.qbk
blob: e4e6cc14aee66e8265360de0849a97c62e4ade60 (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
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
[/
 / Copyright (c) 2003-2015 Christopher M. Kohlhoff (chris at kohlhoff dot com)
 /
 / Distributed under the Boost Software License, Version 1.0. (See accompanying
 / file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
 /]

[section:ConvertibleToMutableBuffer Convertible to mutable buffer requirements]

A type that meets the requirements for convertibility to a mutable buffer must
meet the requirements of `CopyConstructible` types (C++ Std, 20.1.3), and the
requirements of `Assignable` types (C++ Std, 23.1).

In the table below, `X` denotes a class meeting the requirements for
convertibility to a mutable buffer, `a` and `b` denote values of type `X`, and
`u`, `v` and `w` denote identifiers.

[table ConvertibleToMutableBuffer requirements
  [[expression][postcondition]]
  [
    [``
      mutable_buffer u(a);
      mutable_buffer v(a);
    ``]
    [``
      buffer_cast<void*>(u) == buffer_cast<void*>(v)
        && buffer_size(u) == buffer_size(v)
    ``]
  ]
  [
    [``
      mutable_buffer u(a);
      mutable_buffer v = a;
    ``]
    [``
      buffer_cast<void*>(u) == buffer_cast<void*>(v)
        && buffer_size(u) == buffer_size(v)
    ``]
  ]
  [
    [``
      mutable_buffer u(a);
      mutable_buffer v; v = a;
    ``]
    [``
      buffer_cast<void*>(u) == buffer_cast<void*>(v)
        && buffer_size(u) == buffer_size(v)
    ``]
  ]
  [
    [``
      mutable_buffer u(a);
      const X& v = a;
      mutable_buffer w(v);
    ``]
    [``
      buffer_cast<void*>(u) == buffer_cast<void*>(w)
        && buffer_size(u) == buffer_size(w)
    ``]
  ]
  [
    [``
      mutable_buffer u(a);
      X v(a);
      mutable_buffer w(v);
    ``]
    [``
      buffer_cast<void*>(u) == buffer_cast<void*>(w)
        && buffer_size(u) == buffer_size(w)
    ``]
  ]
  [
    [``
      mutable_buffer u(a);
      X v = a;
      mutable_buffer w(v);
    ``]
    [``
      buffer_cast<void*>(u) == buffer_cast<void*>(w)
        && buffer_size(u) == buffer_size(w)
    ``]
  ]
  [
    [``
      mutable_buffer u(a);
      X v(b); v = a;
      mutable_buffer w(v);
    ``]
    [``
      buffer_cast<void*>(u) == buffer_cast<void*>(w)
        && buffer_size(u) == buffer_size(w)
    ``]
  ]
]

[endsect]