QXmlStreamAttributes 类

QXmlStreamAttributes 类表示一个 QXmlStreamAttribute 向量。更多...

头文件 #include <QXmlStreamAttributes>
CMakefind_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmakeQT += core
继承 QList

注意: 此类中所有函数均 可重入

公开函数

QXmlStreamAttributes()
voidappend(const QString &namespaceUri, const QString &name, const QString &value)
voidappend(const QString &qualifiedName, const QString &value)
boolhasAttribute(QAnyStringView qualifiedName) const
boolhasAttribute(QAnyStringView namespaceUri, QAnyStringView name) const
QStringViewvalue(QAnyStringView namespaceUri, QAnyStringView name) const
QStringViewvalue(QAnyStringView qualifiedName) const

详细描述

当阅读器报告 开始元素 时,QXmlStreamReaderattributes() 返回属性。此类还可以与 QXmlStreamWriter 一起使用,作为 writeAttributes() 的参数。

便捷函数 value() 遍历向量,并返回给定 namespaceUri 和属性名称的属性值。

可以使用 append() 添加新属性。

成员函数文档

QXmlStreamAttributes::QXmlStreamAttributes()

QXmlStreamAttributes 构造函数。

void QXmlStreamAttributes::append(const QString &namespaceUri, const QString &name, const QString &value)

在命名空间中添加具有 name 名称的新的属性,且值为 value。命名空间 URI 可以为空。

void QXmlStreamAttributes::append(const QString &qualifiedName, const QString &value)

这是一个重载函数。

附加具有限定名 qualifiedName 和值 value 的新属性。

bool QXmlStreamAttributes::hasAttribute(QAnyStringView qualifiedName) const

如果此 QXmlStreamAttributes 具有具有限定名 qualifiedName 的属性,则返回 true;否则返回 false

请注意,此函数不具有命名空间意识。例如,如果此 QXmlStreamAttributes 包含一个被称为 "xlink:href" 的属性,这并不表示 XLink 命名空间中存在名为 href 的属性,因为 xlink 前缀可以绑定到任何命名空间。为了具有命名空间意识,请使用接受命名空间 URI 和局部名称作为参数的重载函数。

bool QXmlStreamAttributes::hasAttribute(QAnyStringView namespaceUri, QAnyStringView name) const

这是一个重载函数。

如果此 QXmlStreamAttributes 包含具有对应于 namespaceUriname 的命名空间 URI 和名称的属性,则返回 true;否则返回 false

[noexcept] QStringView QXmlStreamAttributes::value(QAnyStringView namespaceUri, QAnyStringView name) const

返回在由 namespaceUri 描述的命名空间中属性 name 的值,如果属性未定义,则返回空字符串引用。《i translate="no">namespaceUri 可以是空的。

注意:在 6.6 之前的 Qt 版本中,此函数作为仅接受组合QStringQLatin1StringView 的重载集来实施。

[noexcept] QStringView QXmlStreamAttributes::value(QAnyStringView qualifiedName) const

这是一个重载函数。

返回具有限定名 qualifiedName 的属性值,如果属性未定义,则返回空字符串引用。限定名是 XML 数据中属性的原始名称。它由命名空间前缀组成,后跟冒号,再跟属性的本地名称。由于命名空间前缀不唯一(同一个前缀可以指向不同的命名空间,不同的前缀可以指向同一个命名空间),因此不应使用限定名,而应使用已解析的命名空间 URI 和属性的本地名称。

注意:在 6.6 之前的 Qt 版本中,此函数作为仅接受QStringQLatin1StringView 的重载集来实施。

© 2024 Qt公司有限公司。本文件中包含的文档贡献均为各自所有者的版权。本文件提供的内容根据由自由软件基金会发布的《GNU自由文档许可证》第1.3版的条款进行许可。Qt及其相关标志是芬兰和/或世界其他地区的Qt公司有限公司的商标。所有其他商标均为各自所有者的财产。