Пожалуйста, учтите, что спецификации и другая информация, содержащаяся здесь, не являются заключительными и могут быть изменены. Информация доступна для вас исключительно ради ознакомления.
Этот модуль, и исходный код и документация, находится в Общедоступном Домене, и прибывает без ГАРАНТИИ. См. http://www.saxproject.org для дополнительной информации.
Этот интерфейс предоставляет доступ к списку атрибутов тремя различными способами:
атрибутом индексируют;
Полностью определенным именем пространства имен; или
квалифицированным (снабженным префиксом) именем.
Список не будет содержать атрибуты, которые были объявлены #IMPLIED, но не определены в теге запуска. Это не будет также содержать атрибуты, используемые в качестве Объявлений пространства имен (xmlns *) если http://xml.org/sax/features/namespace-prefixes функция устанавливается в true (это - false по умолчанию). Поскольку SAX2 приспосабливает исходным "Пространствам имен в XML" рекомендации, это обычно не дает атрибутам объявления пространства имен URI пространства имен.
Некоторые синтаксические анализаторы SAX2 могут поддерживать использование флага дополнительной функции (http://xml.org/sax/features/xmlns-uris) запрашивать что те атрибуты быть данным URI, соответствуя более поздней назад несовместимой версии той рекомендации. ("Локальное имя атрибута" будет префиксом, или "xmlns", определяя пространство имен элемента значения по умолчанию.) Для мобильности код обработчика должен всегда разрешать, что конфликт, вместо того, чтобы требовать синтаксических анализаторов, которые могут изменить настройки того значения параметра.
Если функцией префиксов пространства имен (см. выше) является false, доступ полностью определенным именем, возможно, не доступен; если http://xml.org/sax/features/namespaces функцией является false, доступ Полностью определенными именами пространства имен, возможно, не доступен.
Этот интерфейс заменяет теперь осуждаемый SAX1 AttributeList интерфейс, который не содержит поддержку Пространства имен. В дополнение к поддержке Пространства имен это добавляет методы getIndex (ниже).
Порядок атрибутов в списке является неуказанным, и изменится от реализации до реализации.
Ищите XML атрибута, который индексирует квалифицированное (снабженное префиксом) имя.
Параметры:
index - Атрибут индексирует (основанный на нуле).
Возвраты:
Полностью определенное имя XML, или пустая строка, если ни один не является доступным, или нулевым, если индексирование испытывает недостаток диапазона.
Тип атрибута является одной из строк "CDATA", "ID", "IDREF", "IDREFS", "NMTOKEN", "NMTOKENS", "ОБЪЕКТ", "ОБЪЕКТЫ", или "НОТАЦИЯ" (всегда в верхнем регистре).
Если синтаксический анализатор не считал объявление для атрибута, или если синтаксический анализатор не сообщает о типах атрибута, то это должно возвратить значение "CDATA" как утверждено в XML 1.0 Рекомендация (пункт 3.3.3, "Нормализация Значения атрибута").
Для перечислимого атрибута, который не является нотацией, синтаксический анализатор сообщит о типе как "о NMTOKEN".
Параметры:
index - Атрибут индексирует (основанный на нуле).
Возвраты:
Тип атрибута как строка, или нуль, если индексирование испытывает недостаток диапазона.
Если значение атрибута будет списком маркеров (IDREFS, ОБЪЕКТЫ, или NMTOKENS), то маркеры будут связаны в единственную строку с каждым маркером, разделенным одинарным интервалом.
Параметры:
index - Атрибут индексирует (основанный на нуле).
Возвраты:
Значение атрибута как строка, или нуль, если индексирование испытывает недостаток диапазона.