Класс QXmlNamespaceSupport

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

Этот класс был представлен в Qt 4.4.

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

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

Публичные функции

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

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

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

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

QXmlNamespaceSupport::QXmlNamespaceSupport()

Конструирует QXmlNamespaceSupport.

QXmlNamespaceSupport::~QXmlNamespaceSupport()

Удаляет QXmlNamespaceSupport.

void QXmlNamespaceSupport::popContext()

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

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

См. также 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()

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

Обычно следует создавать новый контекст в начале каждого 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 пространства имён. Используйте пустую строку ("") для пространства имён по умолчанию.