Этот модуль, и исходный код и документация, находится в Общедоступном Домене, и прибывает без ГАРАНТИИ. См. 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 (ниже).
Порядок атрибутов в списке является неуказанным, и изменится от реализации до реализации.
Тип атрибута является одной из строк "CDATA", "ID", "IDREF", "IDREFS", "NMTOKEN", "NMTOKENS", "ОБЪЕКТ", "ОБЪЕКТЫ", или "НОТАЦИЯ" (всегда в верхнем регистре).
Если синтаксический анализатор не считал объявление для атрибута, или если синтаксический анализатор не сообщает о типах атрибута, то это должно возвратить значение "CDATA" как утверждено в XML 1.0 Рекомендация (пункт 3.3.3, "Нормализация Значения атрибута").
Для перечислимого атрибута, который не является нотацией, синтаксический анализатор сообщит о типе как "о NMTOKEN".
Параметры:
index - (Основанный на нуле) индекс атрибута.
Возвраты:
Тип атрибута как строка, или нуль, если индекс испытывает недостаток диапазона.
Если значение атрибута будет списком маркеров (IDREFS, ОБЪЕКТЫ, или NMTOKENS), то маркеры будут связаны в единственную строку с каждым маркером, разделенным одиночным пробелом.
Параметры:
index - (Основанный на нуле) индекс атрибута.
Возвраты:
Значение атрибута как строка, или нуль, если индекс испытывает недостаток диапазона.