QXmlStreamAttributes 类
QXmlStreamAttributes 类表示一个 QXmlStreamAttribute 向量。更多...
头文件 | #include <QXmlStreamAttributes> |
CMake | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
qmake | QT += core |
继承 | QList |
- 所有成员列表,包括继承成员
- QXmlStreamAttributes 是 XML 类 的一部分。
注意: 此类中所有函数均 可重入。
公开函数
QXmlStreamAttributes() | |
void | append(const QString &namespaceUri, const QString &name, const QString &value) |
void | append(const QString &qualifiedName, const QString &value) |
bool | hasAttribute(QAnyStringView qualifiedName) const |
bool | hasAttribute(QAnyStringView namespaceUri, QAnyStringView name) const |
QStringView | value(QAnyStringView namespaceUri, QAnyStringView name) const |
QStringView | value(QAnyStringView qualifiedName) const |
详细描述
当阅读器报告 开始元素 时,QXmlStreamReader 的 attributes() 返回属性。此类还可以与 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 包含具有对应于 namespaceUri 和 name 的命名空间 URI 和名称的属性,则返回 true
;否则返回 false
。
[noexcept]
QStringView QXmlStreamAttributes::value(QAnyStringView namespaceUri, QAnyStringView name) const
返回在由 namespaceUri 描述的命名空间中属性 name 的值,如果属性未定义,则返回空字符串引用。《i translate="no">namespaceUri 可以是空的。
注意:在 6.6 之前的 Qt 版本中,此函数作为仅接受组合QString 和 QLatin1StringView 的重载集来实施。
[noexcept]
QStringView QXmlStreamAttributes::value(QAnyStringView qualifiedName) const
这是一个重载函数。
返回具有限定名 qualifiedName 的属性值,如果属性未定义,则返回空字符串引用。限定名是 XML 数据中属性的原始名称。它由命名空间前缀组成,后跟冒号,再跟属性的本地名称。由于命名空间前缀不唯一(同一个前缀可以指向不同的命名空间,不同的前缀可以指向同一个命名空间),因此不应使用限定名,而应使用已解析的命名空间 URI 和属性的本地名称。
注意:在 6.6 之前的 Qt 版本中,此函数作为仅接受QString 和 QLatin1StringView 的重载集来实施。
© 2024 Qt公司有限公司。本文件中包含的文档贡献均为各自所有者的版权。本文件提供的内容根据由自由软件基金会发布的《GNU自由文档许可证》第1.3版的条款进行许可。Qt及其相关标志是芬兰和/或世界其他地区的Qt公司有限公司的商标。所有其他商标均为各自所有者的财产。