Класс QXmlNamespaceSupport

Класс QXmlNamespaceSupport — вспомогательный класс для XML-ридеров, которые хотят включить поддержку пространств имён. Подробнее...

• Список всех членов, включая унаследованные

Примечание: Все функции в этом классе являются перезаписываемыми.

Открытые функции

Подробное описание

Класс QXmlNamespaceSupport — вспомогательный класс для XML-ридеров, которые хотят включить поддержку пространств имён.

Вы можете задать префикс для текущего пространства имён с помощью setPrefix(), и получить список текущих префиксов (или тех, что для заданного URI) с помощью prefixes(). URI пространства имён доступен из uri(). Используйте pushContext() для начала нового контекста пространства имён и popContext() для возврата к предыдущему контексту пространства имён. Используйте splitName() или processName() для разделения имени на префикс и локальное имя.

См. также Поддержка пространств имён через функции.

Документация функций-членов

QXmlNamespaceSupport::QXmlNamespaceSupport()

Создаёт QXmlNamespaceSupport.

QXmlNamespaceSupport::~QXmlNamespaceSupport()

Удаляет QXmlNamespaceSupport.

void QXmlNamespaceSupport::popContext()

Возвращается к предыдущему контексту пространства имён.

Обычно вы должны вызывать popContext в конце каждого XML-элемента. После вызова popContext все соответствия префикс-пространство имён, которые ранее были активны, восстанавливаются.

См. также pushContext().

QString QXmlNamespaceSupport::prefix(const QString &uri) const

Возвращает один из префиксов, сопоставленных с URI пространства имён uri.

Если более одного префикса сопоставлено с одним и тем же URI, эта функция делает произвольный выбор; если вам нужны все префиксы, используйте prefixes() вместо этого.

Примечание: чтобы проверить наличие стандартного префикса, используйте функцию uri() с аргументом "".

См. также setPrefix().

QStringList QXmlNamespaceSupport::prefixes() const

Возвращает список всех объявленных в настоящее время префиксов.

Если существует стандартный префикс, эта функция не возвращает его в списке; проверьте наличие стандартного префикса с помощью uri() с аргументом "".

QStringList QXmlNamespaceSupport::prefixes(const QString &uri) const

Это перегруженная функция.

Возвращает список всех префиксов, объявленных в настоящее время для URI пространства имён uri.

Префикс "xml:" включён. Если вам нужен только один префикс, сопоставленный с URI пространства имён, и вас не интересует, какой именно, используйте функцию prefix() вместо этого.

Примечание: пустой (стандартный) префикс никогда не включается в этот список; чтобы проверить наличие стандартного пространства имён, вызовите uri() с "" в качестве аргумента.

void QXmlNamespaceSupport::processName(const QString &qname, bool isAttribute, QString &nsuri, QString &localname) const

Обрабатывает исходное имя XML 1.0 в текущем контексте, удаляя префикс и ищя его среди префиксов, объявленных в настоящее время.

qname — это исходное имя XML 1.0, которое нужно обработать. isAttribute равно true, если имя — это имя атрибута.

Эта функция сохраняет URI пространства имён в nsuri (который будет установлен в пустую строку, если исходное имя имеет не объявленный префикс), и сохраняет локальное имя (без префикса) в localname (которое будет установлено в пустую строку, если не используется пространство имён).

Обратите внимание, что имена атрибутов обрабатываются по-другому, чем имена элементов: имя элемента без префикса получает стандартное пространство имён (если оно есть), в то время как имя атрибута без префикса — нет.

void QXmlNamespaceSupport::pushContext()

Начинает новый контекст пространства имён.

Обычно вы должны вызывать pushContext в начале каждого XML-элемента: новый контекст автоматически наследует объявления своего родительского контекста, а также отслеживает объявления, сделанные в этом контексте.

См. также popContext().

void QXmlNamespaceSupport::reset()

Сбрасывает этот объект поддержки пространств имён, готовясь к повторному использованию.

void QXmlNamespaceSupport::setPrefix(const QString &pre, const QString &uri)

Эта функция объявляет префикс pre в текущем контексте пространства имён в качестве URI пространства имён uri. Префикс остаётся в силе до тех пор, пока этот контекст не будет извлечён, если он не будет затенён в дочернем контексте.

Обратите внимание на асимметрию в этой библиотеке. prefix() не возвращает стандартный "" префикс, даже если вы его объявили; чтобы проверить наличие стандартного префикса, вы должны явно его запросить с помощью uri(). Эта асимметрия существует для облегчения поиска префиксов для имён атрибутов, где стандартный префикс не разрешён.

См. также prefix().

void QXmlNamespaceSupport::splitName(const QString &qname, QString &prefix, QString &localname) const

Разделяет имя qname по ':' и возвращает префикс в prefix и локальное имя в localname.

См. также processName().

QString QXmlNamespaceSupport::uri(const QString &prefix) const

Ищет префикс prefix в текущем контексте и возвращает URI пространства имён, который ему сопоставлен. Используйте пустую строку ("") для стандартного пространства имён.