1/****************************************************************************
2**
3** Copyright (C) 2016 Intel Corporation.
4** Contact: https://www.qt.io/licensing/
5**
6** This file is part of the QtNetwork module of the Qt Toolkit.
7**
8** $QT_BEGIN_LICENSE:LGPL$
9** Commercial License Usage
10** Licensees holding valid commercial Qt licenses may use this file in
11** accordance with the commercial license agreement provided with the
12** Software or, alternatively, in accordance with the terms contained in
13** a written agreement between you and The Qt Company. For licensing terms
14** and conditions see https://www.qt.io/terms-conditions. For further
15** information use the contact form at https://www.qt.io/contact-us.
16**
17** GNU Lesser General Public License Usage
18** Alternatively, this file may be used under the terms of the GNU Lesser
19** General Public License version 3 as published by the Free Software
20** Foundation and appearing in the file LICENSE.LGPL3 included in the
21** packaging of this file. Please review the following information to
22** ensure the GNU Lesser General Public License version 3 requirements
23** will be met: https://www.gnu.org/licenses/lgpl-3.0.html.
24**
25** GNU General Public License Usage
26** Alternatively, this file may be used under the terms of the GNU
27** General Public License version 2.0 or (at your option) the GNU General
28** Public license version 3 or any later version approved by the KDE Free
29** Qt Foundation. The licenses are as published by the Free Software
30** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3
31** included in the packaging of this file. Please review the following
32** information to ensure the GNU General Public License requirements will
33** be met: https://www.gnu.org/licenses/gpl-2.0.html and
34** https://www.gnu.org/licenses/gpl-3.0.html.
35**
36** $QT_END_LICENSE$
37**
38****************************************************************************/
39
40#ifndef QNETWORKDATAGRAM_H
41#define QNETWORKDATAGRAM_H
42
43#include <QtCore/qbytearray.h>
44#include <QtNetwork/qhostaddress.h>
45
46#ifndef QT_NO_UDPSOCKET
47
48QT_BEGIN_NAMESPACE
49
50class QNetworkDatagramPrivate;
51class QUdpSocketPrivate;
52
53class Q_NETWORK_EXPORT QNetworkDatagram
54{
55public:
56 QNetworkDatagram();
57 QNetworkDatagram(const QByteArray &data, const QHostAddress &destinationAddress = QHostAddress(),
58 quint16 port = 0); // implicit
59 QNetworkDatagram(const QNetworkDatagram &other);
60 QNetworkDatagram &operator=(const QNetworkDatagram &other);
61 ~QNetworkDatagram()
62 { if (d) destroy(d); }
63
64 QNetworkDatagram(QNetworkDatagram &&other) noexcept
65 : d(other.d)
66 { other.d = nullptr; }
67 QNetworkDatagram &operator=(QNetworkDatagram &&other) noexcept
68 { swap(other); return *this; }
69
70 void swap(QNetworkDatagram &other) noexcept
71 { qSwap(d, other.d); }
72
73 void clear();
74 bool isValid() const;
75 bool isNull() const
76 { return !isValid(); }
77
78 uint interfaceIndex() const;
79 void setInterfaceIndex(uint index);
80
81 QHostAddress senderAddress() const;
82 QHostAddress destinationAddress() const;
83 int senderPort() const;
84 int destinationPort() const;
85 void setSender(const QHostAddress &address, quint16 port = 0);
86 void setDestination(const QHostAddress &address, quint16 port);
87
88 int hopLimit() const;
89 void setHopLimit(int count);
90
91 QByteArray data() const;
92 void setData(const QByteArray &data);
93
94#if defined(Q_COMPILER_REF_QUALIFIERS) || defined(Q_CLANG_QDOC)
95 QNetworkDatagram makeReply(const QByteArray &payload) const &
96 { return makeReply_helper(payload); }
97 QNetworkDatagram makeReply(const QByteArray &payload) &&
98 { makeReply_helper_inplace(payload); return *this; }
99#else
100 QNetworkDatagram makeReply(const QByteArray &paylaod) const
101 { return makeReply_helper(paylaod); }
102#endif
103
104private:
105 QNetworkDatagramPrivate *d;
106 friend class QUdpSocket;
107 friend class QSctpSocket;
108
109 explicit QNetworkDatagram(QNetworkDatagramPrivate &dd);
110 QNetworkDatagram makeReply_helper(const QByteArray &data) const;
111 void makeReply_helper_inplace(const QByteArray &data);
112 static void destroy(QNetworkDatagramPrivate *d);
113};
114
115Q_DECLARE_SHARED(QNetworkDatagram)
116
117QT_END_NAMESPACE
118
119Q_DECLARE_METATYPE(QNetworkDatagram)
120
121#endif // QT_NO_UDPSOCKET
122
123#endif // QNETWORKDATAGRAM_H
124