Revision control
Copy as Markdown
// Copyright (C) 2023 basysKom GmbH, opensource@basyskom.com
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only
// Qt-Security score:significant reason:default
#include "qopcuavariant.h"
#include <QtCore/qdatetime.h>
#include <QtCore/qlist.h>
#include <QtCore/quuid.h>
#include <QtCore/qvariant.h>
QT_BEGIN_NAMESPACE
class QOpcUaVariantData : public QSharedData
{
public:
void updateIsArray()
{
const QMetaType metaType = value.metaType();
const auto name = QUtf8StringView(metaType.name());
isArray = (name.size() > 6 && name.first(6) == QUtf8StringView("QList<"))
|| name == QUtf8StringView("QStringList")
|| name == QUtf8StringView("QVariantList");
}
QVariant value;
QOpcUaVariant::ValueType valueType = QOpcUaVariant::ValueType::Unknown;
QList<qint32> arrayDimensions;
bool isArray = false;
};
QT_DEFINE_QESDP_SPECIALIZATION_DTOR(QOpcUaVariantData)
/*!
\class QOpcUaVariant
\inmodule QtOpcUa
\since 6.7
\brief The OPC UA Variant.
The OPC UA variant is an union of all built-in OPC UA types and also contains
information about the array dimensions associated with the value.
This class is currently only supported by \l QOpcUaBinaryDataEncoding and
\l QOpcUaGenericStructHandler.
*/
/*!
\enum QOpcUaVariant::ValueType
This enum contains the possible value types of an OPC UA variant.
\value Unknown
\value Boolean
\value SByte
\value Byte
\value Int16
\value UInt16
\value Int32
\value UInt32,
\value Int64
\value UInt64
\value Float
\value Double
\value String
\value DateTime
\value Guid
\value ByteString
\value XmlElement
\value NodeId
\value ExpandedNodeId
\value StatusCode
\value QualifiedName
\value LocalizedText
\value ExtensionObject
\value DataValue
\value Variant
\value DiagnosticInfo
*/
/*!
\fn QOpcUaVariant::QOpcUaVariant(QOpcUaVariant &&other)
Move-constructs a new OPC UA variant from \a other.
\note The moved-from object \a other is placed in a
partially-formed state, in which the only valid operations are
destruction and assignment of a new value.
*/
/*!
\fn QOpcUaVariant &QOpcUaVariant::operator=(QOpcUaVariant &&other)
Move-assigns \a other to this QOpcUaVariant instance.
\note The moved-from object \a other is placed in a
partially-formed state, in which the only valid operations are
destruction and assignment of a new value.
*/
/*!
\fn void QOpcUaVariant::swap(QOpcUaVariant &other)
Swaps enum definition object \a other with this OPC UA variant
object. This operation is very fast and never fails.
*/
/*!
\fn bool QOpcUaVariant::operator!=(const QOpcUaVariant &lhs, const QOpcUaVariant &rhs) noexcept
Returns \c true if \a lhs is not equal to \a rhs.
*/
/*!
\fn bool QOpcUaVariant::operator==(const QOpcUaVariant &lhs, const QOpcUaVariant &rhs) noexcept
Returns \c true if \a lhs is equal to \a rhs.
*/
/*!
Default constructs a new OPC UA variant.
*/
QOpcUaVariant::QOpcUaVariant()
: data(new QOpcUaVariantData)
{
}
/*!
Constructs a new OPC UA variant from \a other.
*/
QOpcUaVariant::QOpcUaVariant(const QOpcUaVariant &other)
: data(other.data)
{
}
/*!
Constructs a new OPC UA variant of type \a type with value \a value.
Scalar values must be passed as a \l QVariant containing a value of \a type.
Array values must be passed as a \l QVariant containing a \l QList of \a type.
*/
QOpcUaVariant::QOpcUaVariant(ValueType type, const QVariant &value)
: data(new QOpcUaVariantData)
{
setValue(type, value);
}
/*!
Constructs a new OPC UA variant of type \a type with value \a value and array dimensions \a arrayDimensions.
Scalar values must be passed as a \l QVariant containing a value of \a type.
Array values must be passed as a \l QVariant containing a \l QList of \a type.
*/
QOpcUaVariant::QOpcUaVariant(ValueType type, const QVariant &value, const QList<qint32> arrayDimensions)
: data(new QOpcUaVariantData)
{
setValue(type, value, arrayDimensions);
}
/*!
Destroys this OPC UA variant.
*/
QOpcUaVariant::~QOpcUaVariant()
{
}
/*!
Sets the values from \a rhs in this OPC UA variant.
*/
QOpcUaVariant &QOpcUaVariant::operator=(const QOpcUaVariant &rhs)
{
if (this != &rhs)
data.operator=(rhs.data);
return *this;
}
bool comparesEqual(const QOpcUaVariant &lhs, const QOpcUaVariant &rhs) noexcept
{
return lhs.data->value == rhs.data->value &&
lhs.data->valueType == rhs.data->valueType &&
lhs.data->arrayDimensions == rhs.data->arrayDimensions;
}
/*!
Returns the value of this OPC UA variant.
*/
QVariant QOpcUaVariant::value() const
{
return data->value;
}
/*!
Sets the value of this OPC UA variant to \a value and the type to \a type.
Scalar values must be passed as a \l QVariant containing a value of \a type.
Array values must be passed as a \l QVariant containing a \l QList of \a type.
*/
void QOpcUaVariant::setValue(ValueType type, const QVariant &value)
{
if (type != data->valueType || value != data->value || !data->arrayDimensions.isEmpty()) {
data.detach();
data->valueType = type;
data->value = value;
data->updateIsArray();
}
}
/*!
Sets the value of this OPC UA variant to \a value, the type to \a type and the array dimensions to \a arrayDimensions.
Scalar values must be passed as a \l QVariant containing a value of \a type.
Array values must be passed as a \l QVariant containing a \l QList of \a type.
*/
void QOpcUaVariant::setValue(ValueType type, const QVariant &value, const QList<qint32> &arrayDimensions)
{
if (type != data->valueType || value != data->value || arrayDimensions != data->arrayDimensions) {
data.detach();
data->valueType = type;
data->value = value;
data->arrayDimensions = arrayDimensions;
data->updateIsArray();
}
}
/*!
Returns the value type of this OPC UA variant.
*/
QOpcUaVariant::ValueType QOpcUaVariant::type() const
{
return data->valueType;
}
/*!
Returns \c true if this OPC UA variant contains an array value.
*/
bool QOpcUaVariant::isArray() const
{
return data->isArray;
}
/*!
Returns the array dimensions of this OPC UA variant.
*/
QList<qint32> QOpcUaVariant::arrayDimensions() const
{
return data->arrayDimensions;
}
/*!
Sets the array dimensions to \a arrayDimensions.
*/
void QOpcUaVariant::setArrayDimensions(const QList<qint32> &arrayDimensions)
{
if (data->arrayDimensions != arrayDimensions) {
data.detach();
data->arrayDimensions = arrayDimensions;
}
}
/*!
Returns a \l QVariant containing this OPC UA variant.
*/
QOpcUaVariant::operator QVariant() const
{
return QVariant::fromValue(*this);
}
QT_END_NAMESPACE