aboutsummaryrefslogtreecommitdiffstats
path: root/src/qml/debugger/qpacket.cpp
diff options
context:
space:
mode:
Diffstat (limited to 'src/qml/debugger/qpacket.cpp')
-rw-r--r--src/qml/debugger/qpacket.cpp147
1 files changed, 147 insertions, 0 deletions
diff --git a/src/qml/debugger/qpacket.cpp b/src/qml/debugger/qpacket.cpp
new file mode 100644
index 0000000000..30f2191689
--- /dev/null
+++ b/src/qml/debugger/qpacket.cpp
@@ -0,0 +1,147 @@
+/****************************************************************************
+**
+** Copyright (C) 2015 The Qt Company Ltd.
+** Contact: http://www.qt.io/licensing/
+**
+** This file is part of the QtQml module of the Qt Toolkit.
+**
+** $QT_BEGIN_LICENSE:LGPL21$
+** Commercial License Usage
+** Licensees holding valid commercial Qt licenses may use this file in
+** accordance with the commercial license agreement provided with the
+** Software or, alternatively, in accordance with the terms contained in
+** a written agreement between you and The Qt Company. For licensing terms
+** and conditions see http://www.qt.io/terms-conditions. For further
+** information use the contact form at http://www.qt.io/contact-us.
+**
+** GNU Lesser General Public License Usage
+** Alternatively, this file may be used under the terms of the GNU Lesser
+** General Public License version 2.1 or version 3 as published by the Free
+** Software Foundation and appearing in the file LICENSE.LGPLv21 and
+** LICENSE.LGPLv3 included in the packaging of this file. Please review the
+** following information to ensure the GNU Lesser General Public License
+** requirements will be met: https://www.gnu.org/licenses/lgpl.html and
+** http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
+**
+** As a special exception, The Qt Company gives you certain additional
+** rights. These rights are described in The Qt Company LGPL Exception
+** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
+**
+** $QT_END_LICENSE$
+**
+****************************************************************************/
+
+#include "qpacket_p.h"
+
+QT_BEGIN_NAMESPACE
+
+/*!
+ \class QPacket
+ \internal
+
+ \brief The QPacket class encapsulates an unfragmentable packet of data to be
+ transmitted by QPacketProtocol.
+
+ The QPacket class works together with QPacketProtocol to make it simple to
+ send arbitrary sized data "packets" across fragmented transports such as TCP
+ and UDP.
+
+ QPacket provides a QDataStream interface to an unfragmentable packet.
+ Applications should construct a QPacket, propagate it with data and then
+ transmit it over a QPacketProtocol instance. For example:
+ \code
+ QPacketProtocol protocol(...);
+
+ QPacket myPacket;
+ myPacket << "Hello world!" << 123;
+ protocol.send(myPacket);
+ \endcode
+
+ As long as both ends of the connection are using the QPacketProtocol class,
+ the data within this packet will be delivered unfragmented at the other end,
+ ready for extraction.
+
+ \code
+ QByteArray greeting;
+ int count;
+
+ QPacket myPacket = protocol.read();
+
+ myPacket >> greeting >> count;
+ \endcode
+
+ Only packets constructed from raw byte arrays may be read from. Empty QPacket
+ instances are for transmission only and are considered "write only". Attempting
+ to read data from them will result in undefined behavior.
+
+ \ingroup io
+ \sa QPacketProtocol
+ */
+
+int QPacket::s_dataStreamVersion = QDataStream::Qt_4_7;
+
+void QPacket::setDataStreamVersion(int dataStreamVersion)
+{
+ s_dataStreamVersion = dataStreamVersion;
+}
+
+int QPacket::dataStreamVersion()
+{
+ return s_dataStreamVersion;
+}
+
+/*!
+ Constructs an empty write-only packet.
+ */
+QPacket::QPacket()
+{
+ init(QIODevice::WriteOnly);
+}
+
+/*!
+ Creates a copy of \a other. The initial stream positions are shared, but the
+ two packets are otherwise independent.
+ */
+QPacket::QPacket(const QPacket &other) : QDataStream()
+{
+ assign(other);
+}
+
+QPacket &QPacket::operator=(const QPacket &other)
+{
+ if (this != &other) {
+ buf.close();
+ assign(other);
+ }
+ return *this;
+}
+
+QPacket::QPacket(const QByteArray &data)
+{
+ buf.setData(data);
+ init(QIODevice::ReadOnly);
+}
+
+/*!
+ Returns raw packet data.
+ */
+QByteArray QPacket::data() const
+{
+ return buf.data();
+}
+
+void QPacket::init(QIODevice::OpenMode mode)
+{
+ buf.open(mode);
+ setDevice(&buf);
+ setVersion(s_dataStreamVersion);
+}
+
+void QPacket::assign(const QPacket &other)
+{
+ buf.setData(other.buf.data());
+ init(other.buf.openMode());
+ buf.seek(other.buf.pos());
+}
+
+QT_END_NAMESPACE