summaryrefslogtreecommitdiffstats
path: root/src/serialport/qserialportinfo.cpp
diff options
context:
space:
mode:
authorLaszlo Papp <lpapp@kde.org>2013-01-27 05:11:23 +0000
committerLaszlo Papp <lpapp@kde.org>2013-01-27 17:05:23 +0100
commitb0910f0651507a1dc5f4acfbd0a1c225921d080c (patch)
tree88d004271e9b5bff702d5e2500a66f52891b238b /src/serialport/qserialportinfo.cpp
parent6623ce7090138e4169bacdfc0c84cdbfbb78ba77 (diff)
Make all the file renames and relevant changes
"git log --follow /path/to/the/file/in/question" can be used, for instance, for the renamed files to get the whole history. Change-Id: I20da087ca88e2c179a6c3232772fa21575e0aa6a Reviewed-by: Denis Shienkov <denis.shienkov@gmail.com>
Diffstat (limited to 'src/serialport/qserialportinfo.cpp')
-rw-r--r--src/serialport/qserialportinfo.cpp242
1 files changed, 242 insertions, 0 deletions
diff --git a/src/serialport/qserialportinfo.cpp b/src/serialport/qserialportinfo.cpp
new file mode 100644
index 00000000..f8afe0a4
--- /dev/null
+++ b/src/serialport/qserialportinfo.cpp
@@ -0,0 +1,242 @@
+/****************************************************************************
+**
+** Copyright (C) 2011-2012 Denis Shienkov <denis.shienkov@gmail.com>
+** Copyright (C) 2011 Sergey Belyashov <Sergey.Belyashov@gmail.com>
+** Copyright (C) 2012 Laszlo Papp <lpapp@kde.org>
+** Contact: http://www.qt-project.org/legal
+**
+** This file is part of the QtSerialPort module of the Qt Toolkit.
+**
+** $QT_BEGIN_LICENSE:LGPL$
+** 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 Digia. For licensing terms and
+** conditions see http://qt.digia.com/licensing. For further information
+** use the contact form at http://qt.digia.com/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 as published by the Free Software
+** Foundation and appearing in the file LICENSE.LGPL included in the
+** packaging of this file. Please review the following information to
+** ensure the GNU Lesser General Public License version 2.1 requirements
+** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
+**
+** In addition, as a special exception, Digia gives you certain additional
+** rights. These rights are described in the Digia Qt LGPL Exception
+** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
+**
+** GNU General Public License Usage
+** Alternatively, this file may be used under the terms of the GNU
+** General Public License version 3.0 as published by the Free Software
+** Foundation and appearing in the file LICENSE.GPL included in the
+** packaging of this file. Please review the following information to
+** ensure the GNU General Public License version 3.0 requirements will be
+** met: http://www.gnu.org/copyleft/gpl.html.
+**
+**
+** $QT_END_LICENSE$
+**
+****************************************************************************/
+
+#include "qserialportinfo.h"
+#include "qserialportinfo_p.h"
+#include "qserialport.h"
+
+QT_BEGIN_NAMESPACE_SERIALPORT
+
+
+/*!
+ \class QSerialPortInfo
+
+ \brief The QSerialPortInfo class provides information about
+ existing serial ports.
+
+ \ingroup serialport-main
+ \inmodule QtSerialPort
+ \since 5.0
+
+ Use the static functions to generate a list of QSerialPortInfo
+ objects. Each QSerialPortInfo object in the list represents a single
+ serial port and can be queried for the port name, system location,
+ description, and manufacturer. The QSerialPortInfo class can also be
+ used as an input parameter for the setPort() method of the QSerialPort
+ class.
+
+ \sa QSerialPort
+*/
+
+/*!
+ Constructs an empty QSerialPortInfo object.
+
+ \sa isNull()
+*/
+QSerialPortInfo::QSerialPortInfo()
+ : d_ptr(new QSerialPortInfoPrivate)
+{
+}
+
+/*!
+ Constructs a copy of \a other.
+*/
+QSerialPortInfo::QSerialPortInfo(const QSerialPortInfo &other)
+ : d_ptr(other.d_ptr ? new QSerialPortInfoPrivate(*other.d_ptr) : 0)
+{
+}
+
+/*!
+ Constructs a QSerialPortInfo object from serial \a port.
+*/
+QSerialPortInfo::QSerialPortInfo(const QSerialPort &port)
+ : d_ptr(new QSerialPortInfoPrivate)
+{
+ foreach (const QSerialPortInfo &info, availablePorts()) {
+ if (port.portName() == info.portName()) {
+ *this = info;
+ break;
+ }
+ }
+}
+
+/*!
+ Constructs a QSerialPortInfo object from serial port \a name.
+
+ This constructor finds the relevant serial port among the available ones
+ according to the port name \a name, and constructs the serial port info
+ instance for that port.
+*/
+QSerialPortInfo::QSerialPortInfo(const QString &name)
+ : d_ptr(new QSerialPortInfoPrivate)
+{
+ foreach (const QSerialPortInfo &info, availablePorts()) {
+ if (name == info.portName()) {
+ *this = info;
+ break;
+ }
+ }
+}
+
+/*!
+ Destroys the QSerialPortInfo object. References to the values in the
+ object become invalid.
+*/
+QSerialPortInfo::~QSerialPortInfo()
+{
+}
+
+/*! \fn void QSerialPortInfo::swap(QSerialPortInfo &other)
+
+ Swaps QSerialPortInfo \a other with this QSerialPortInfo. This operation is
+ very fast and never fails.
+*/
+void QSerialPortInfo::swap(QSerialPortInfo &other)
+{
+ d_ptr.swap(other.d_ptr);
+}
+
+/*!
+ Sets the QSerialPortInfo object to be equal to \a other.
+*/
+QSerialPortInfo& QSerialPortInfo::operator=(const QSerialPortInfo &other)
+{
+ QSerialPortInfo(other).swap(*this);
+ return *this;
+}
+
+/*!
+ Returns the name of the serial port.
+*/
+QString QSerialPortInfo::portName() const
+{
+ Q_D(const QSerialPortInfo);
+ return !d ? QString() : d->portName;
+}
+
+/*!
+ Returns the system location of the serial port.
+*/
+QString QSerialPortInfo::systemLocation() const
+{
+ Q_D(const QSerialPortInfo);
+ return !d ? QString() : d->device;
+}
+
+/*!
+ Returns the description string of the serial port,
+ if available; otherwise returns an empty string.
+*/
+QString QSerialPortInfo::description() const
+{
+ Q_D(const QSerialPortInfo);
+ return !d ? QString() : d->description;
+}
+
+/*!
+ Returns the manufacturer string of the serial port,
+ if available; otherwise returns an empty string.
+*/
+QString QSerialPortInfo::manufacturer() const
+{
+ Q_D(const QSerialPortInfo);
+ return !d ? QString() : d->manufacturer;
+}
+
+/*!
+ Returns the vendor identifier string of the serial
+ port in hexadecimal format, if available; otherwise
+ returns an empty string.
+*/
+QString QSerialPortInfo::vendorIdentifier() const
+{
+ Q_D(const QSerialPortInfo);
+ return !d ? QString() : d->vendorIdentifier;
+}
+
+/*!
+ Returns the product identifier string of the serial
+ port in hexadecimal format, if available; otherwise
+ returns an empty string.
+*/
+QString QSerialPortInfo::productIdentifier() const
+{
+ Q_D(const QSerialPortInfo);
+ return !d ? QString() : d->productIdentifier;
+}
+
+/*!
+ \fn bool QSerialPortInfo::isNull() const
+
+ Returns whether this QSerialPortInfo object holds a
+ serial port definition.
+*/
+
+/*!
+ \fn bool QSerialPortInfo::isBusy() const
+
+ Returns true if serial port is busy;
+ otherwise returns false.
+*/
+
+/*!
+ \fn bool QSerialPortInfo::isValid() const
+
+ Returns true if serial port is present on system;
+ otherwise returns false.
+*/
+
+/*!
+ \fn QList<qint32> QSerialPortInfo::standardRates()
+
+ Returns a list of available standard baud rates supported by
+ the current serial port.
+*/
+
+/*!
+ \fn QList<QSerialPortInfo> QSerialPortInfo::availablePorts()
+
+ Returns a list of available serial ports on the system.
+*/
+
+QT_END_NAMESPACE_SERIALPORT