Г. Россум , Ф. Л. Дж. Дрейк , Д. С. Откидач , М. Задка , М. Левис , С. Монтаро , Э. С. Реймонд , А. М. Кучлинг , М.-А. Лембург , К.-П. Йи , Д. Ксиллаг , Х. Петрилли , Б. А. Варсав , Дж. К. Ахлстром , Дж. Роскинд , Н. Шеменор , С. Мулендер - Язык программирования Python

SAXNotRecognizedException, если синтаксический анализатор не поддерживает указанную особенность — генерирует
исключение SAXNotSupportedException.
getProperty(propertyname)
Возвращает текущие установки для свойства propertyname. Если свойство
неизвестно, генерирует исключение SAXNotRecognizedException. Символические константы для наиболее известных имен свойств определены в модуле
xml.sax.handler.
setProperty(propertyname, value)
Изменяет установки для свойства propertyname. Для неизвестных свойств
генерирует исключение SAXNotRecognizedException, если синтаксический
анализатор не поддерживает указанное свойство — генерирует исключение
SAXNotSupportedException.

29.8.2

Интерфейс класса IncrementalParser

Класс IncrementalParser является производным от XMLReader, его интерфейс имеет несколько дополнительных методов:
feed(data)
Анализирует порцию данных data.

402

Глава 29. Средства работы с языками структурной разметки

close()
Вызов этого метода указывает на конец документа.
reset()
Этот метод должен быть вызван после метода close() для подготовки к анализу
следующего документа.

29.8.3

Интерфейс класса Locator

Интерфейс класса Locator составляют следующие методы:
getColumnNumber()
Возвращает номер позиции в строке, в которой заканчиваются данные, соответствующие текущему событию (-1, если позиция неизвестна).
getLineNumber()
Возвращает номер строки, в которой заканчиваются данные, соответствующие текущему событию (-1, если номер строки неизвестен).
getPublicId()
Возвращает публичный идентификатор для текущего события (None, если публичный идентификатор не может быть установлен).
getSystemId()
Возвращает системный идентификатор для текущего события (None, если системный идентификатор не может быть установлен).

29.8.4

Экземпляры класса InputSource

Экземпляры класса InputSource имеют следующие методы:
setPublicId(id)
Устанавливает публичный идентификатор документа равным строке id.
getPublicId()
Возвращает публичный идентификатор документа.
setSystemId(id)
Устанавливает системный идентификатор документа равным строке id.
getSystemId()
Возвращает системный идентификатор документа.
setEncoding(encoding)
Устанавливает кодировку документа. Аргумент encoding должен быть строкой,

29.8. xml.sax.xmlreader — интерфейс объектов, . . .

403

применимой для использования в объявлении кодировки XML-документа. Установленная кодировка будет проигнорирована синтаксическим анализатором документа, если установлен символьный поток, осуществляющий автоматическое преобразование.
getEncoding()
Возвращает кодировку документа или None, если кодировка неизвестна.
setByteStream(bytefile)
Устанавливает байтовый поток (файловый или подобный объект, не выполняющий преобразование байтов в символы), из которого будет производиться чтение документа. Кодировка потока может быть установлена с помощью метода
setEncoding. Байтовый поток не будет использоваться синтаксическим анализатором документа, если установлен символьный поток, осуществляющий автоматическое преобразование байтов (в определенной кодировке) в символы Unicode.
getByteStream()
Возвращает байтовый поток, из которого должно производиться чтение документа.
Кодировка этого потока может быть получена с помощью метода getEncoding.
setCharacterStream(charfile)
Устанавливает символьный поток (файловый или подобный объект, осуществляющий автоматическое преобразование байтов в определенной кодировке в символы
Unicode), из которого должно производиться чтение документа.
getCharacterStream()
Возвращает символьный поток, из которого должно производиться чтение документа.

29.8.5

Экземпляры классов AttributesImpl и AttributesNSImpl

Экземпляры классов AttributesImpl и AttributesNSImpl являются отображениями, в качестве ключей в которых выступают именами атрибутов, и в качестве значений — их значения. Для экземпляров класса AttributesImpl имена атрибутов (а
также аргумент name описанных ниже методов) являются строками, для экземпляров
AttributesNSImpl — кортежами из двух строк: с URI пространства имен и локального имени атрибута. Полное имя атрибута (аргумент qname методов) в обоих случаях
является строкой. Помимо общих для всех отображений операций и основных методов
(copy(), get(), has_key(), items(), keys() и values()) они имеют следующие
методы:
getLength()
Возвращает число атрибутов.
getNames()
Возвращает список имен атрибутов (ключей отображения).

404

Глава 29. Средства работы с языками структурной разметки

getType(name)
Возвращает тип атрибута с именем name (обычно ’CDATA’).
getValue(name)
Возвращает значение атрибута с именем --">