Qpid Proton C++ API 0.39.0
 
Loading...
Searching...
No Matches
value.hpp
Go to the documentation of this file.
1#ifndef PROTON_VALUE_HPP
2#define PROTON_VALUE_HPP
3
4/*
5 *
6 * Licensed to the Apache Software Foundation (ASF) under one
7 * or more contributor license agreements. See the NOTICE file
8 * distributed with this work for additional information
9 * regarding copyright ownership. The ASF licenses this file
10 * to you under the Apache License, Version 2.0 (the
11 * "License"); you may not use this file except in compliance
12 * with the License. You may obtain a copy of the License at
13 *
14 * http://www.apache.org/licenses/LICENSE-2.0
15 *
16 * Unless required by applicable law or agreed to in writing,
17 * software distributed under the License is distributed on an
18 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
19 * KIND, either express or implied. See the License for the
20 * specific language governing permissions and limitations
21 * under the License.
22 *
23 */
24
25#include "./codec/encoder.hpp"
26#include "./codec/decoder.hpp"
27#include "./internal/type_traits.hpp"
28#include "./scalar.hpp"
29#include "./types_fwd.hpp"
30
31#include <proton/type_compat.h>
32
33#include <iosfwd>
34
37
38namespace proton {
39
40namespace internal {
41
42// Separate value data from implicit conversion constructors to avoid template recursion.
43class value_base {
44 protected:
45 internal::data& data();
46 internal::data data_;
47
48 friend class codec::encoder;
49 friend class codec::decoder;
50};
51
52} // internal
53
57class value : public internal::value_base, private internal::comparable<value> {
58 private:
59 // Enabler for encodable types excluding proton::value.
60 template<class T, class U=void> struct assignable :
61 public std::enable_if<codec::is_encodable<T>::value, U> {};
62 template<class U> struct assignable<value, U> {};
63
64 public:
66 PN_CPP_EXTERN value();
67
70 PN_CPP_EXTERN value(const value&);
71 PN_CPP_EXTERN value& operator=(const value&);
72 PN_CPP_EXTERN value(value&&);
73 PN_CPP_EXTERN value& operator=(value&&);
75
77 template <class T> value(const T& x, typename assignable<T>::type* = 0) { *this = x; }
78
80 template <class T> typename assignable<T, value&>::type operator=(const T& x) {
81 codec::encoder e(*this);
82 e << x;
83 return *this;
84 }
85
87 PN_CPP_EXTERN type_id type() const;
88
90 PN_CPP_EXTERN bool empty() const;
91
93 PN_CPP_EXTERN void clear();
94
96 template<class T> PN_CPP_DEPRECATED("Use 'proton::get'") void get(T &t) const;
97 template<class T> PN_CPP_DEPRECATED("Use 'proton::get'") T get() const;
99
101 friend PN_CPP_EXTERN void swap(value&, value&);
102
105 friend PN_CPP_EXTERN bool operator==(const value& x, const value& y);
106 friend PN_CPP_EXTERN bool operator<(const value& x, const value& y);
108
113 friend PN_CPP_EXTERN std::ostream& operator<<(std::ostream&, const value&);
114
117 value(pn_data_t* d); // Refer to existing pn_data_t
118 void reset(pn_data_t* d = 0); // Refer to a new pn_data_t
120};
121
124template<class T> T get(const value& v) { T x; get(v, x); return x; }
125
131template<class T> void get(const value& v, T& x) { codec::decoder d(v, true); d >> x; }
132
134template<class T, class U> inline void get(const U& u, T& x) { const value v(u); get(v, x); }
135
138template<class T> T coerce(const value& v) { T x; coerce(v, x); return x; }
139
145template<class T> void coerce(const value& v, T& x) {
146 codec::decoder d(v, false);
147 scalar s;
148 if (type_id_is_scalar(v.type())) {
149 d >> s;
150 x = internal::coerce<T>(s);
151 } else {
152 d >> x;
153 }
154}
155
157template<> inline void get<null>(const value& v, null&) {
159}
160
162template<> inline void get<decltype(nullptr)>(const value& v, decltype(nullptr)&) {
164}
165
167PN_CPP_EXTERN std::string to_string(const value& x);
168
170template<class T> void value::get(T &x) const { x = proton::get<T>(*this); }
171template<class T> T value::get() const { return proton::get<T>(*this); }
173
174} // proton
175
176#endif // PROTON_VALUE_HPP
Unsettled API - A stream-like decoder from AMQP bytes to C++ values.
Definition: decoder.hpp:56
Unsettled API - A stream-like encoder from C++ values to AMQP bytes.
Definition: encoder.hpp:50
The type of the AMQP null value.
Definition: null.hpp:38
A holder for an instance of any scalar AMQP type.
Definition: scalar.hpp:37
A holder for any AMQP value, simple or complex.
Definition: value.hpp:57
T get(const value &v)
Get a contained value of type T.
Definition: value.hpp:124
void get(const value &v, T &x)
Like get(const value&) but extracts the value to a reference x instead of returning it.
Definition: value.hpp:131
T coerce(const value &v)
Coerce the contained value to type T.
Definition: value.hpp:138
void coerce(const value &v, T &x)
Like coerce(const value&) but assigns the value to a reference instead of returning it.
Definition: value.hpp:145
bool empty() const
True if the value is null.
assignable< T, value & >::type operator=(const T &x)
Assign from any allowed type T.
Definition: value.hpp:80
type_id type() const
Get the type ID for the current value.
void clear()
Reset the value to null/empty.
value(const T &x, typename assignable< T >::type *=0)
Copy from any allowed type T.
Definition: value.hpp:77
value()
Create a null value.
friend void swap(value &, value &)
swap values
Unsettled API - A stream-like decoder from AMQP bytes to C++ values.
Unsettled API - A stream-like encoder from C++ values to AMQP bytes.
The main Proton namespace.
Definition: annotation_key.hpp:33
void get< decltype(nullptr)>(const value &v, decltype(nullptr)&)
Special case for null, just checks that value contains NULL.
Definition: value.hpp:162
std::string to_string(const message &)
Human readable string representation.
void get< null >(const value &v, null &)
Special case for null, just checks that value contains NULL.
Definition: value.hpp:157
type_id
An identifier for AMQP types.
Definition: type_id.hpp:37
@ NULL_TYPE
The null type, contains no data.
Definition: type_id.hpp:38
void assert_type_equal(type_id want, type_id got)
Throw a conversion_error if want != got with a message including the names of the types.
A holder for an instance of any scalar AMQP type.
Forward declarations for Proton types used to represent AMQP types.