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

Класс IncrementalParser является производным от XMLReader, его интерфейс имеет несколько дополнительных методов:

feed( data)

Анализирует порцию данных data.

него класса). По умолчанию (до вызова этого метода) используется объект, открывающий документ, на который указывает системный идентификатор (отсутствие в определении сущности системного идентификатора приведет к ошибке).

getErrorHandler()

Возвращает текущий обработчик ошибок (экземпляр

xml.sax.handler.ErrorHandler или производного от него класса).

setErrorHandler( handler)

Устанавливает handler в качестве текущего обработчика ошибок. По умолчанию (до вызова этого метода) используется объект, генерирующий исключение в случае ошибок и выводящий предупреждения на стандартный поток вывода (sys.stdout).

setLocale( locale)

Устанавливает язык и кодировку сообщений об ошибках и предупреждений.

getFeature( featurename)

Возвращает текущие установки для особенности с именем featurename. Если особенность неизвестна, генерирует исключение SAXNotRecognizedException. Символические константы для наиболее известных имен особенностей определены в модуле xml.sax.handler.

setFeature(featurename, value)

Изменяет установки для особенности с именем featurename. Для неизвестных особенностей генерирует исключение SAXNotRecognizedException, если синтаксический анализатор не поддерживает указанную особенность - генерирует исключение SAXNotSupportedException.

getProperty( propertyname)

Возвращает текущие установки для свойства propertyname. Если свойство неизвестно, генерирует исключение SAXNotRecognizedException. Символические константы для наиболее известных имен свойств определены в модуле xml.sax.handler.

setProperty( propertyname, value)

Изменяет установки для свойства propertyname. Для неизвестных свойств генерирует исключение SAXNotRecognizedException, если синтаксический анализатор не поддерживает указанное свойство - генерирует исключение

SAXNotSupportedException.

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 должен быть строкой,

close()

Вызов этого метода указывает на конец документа.

reset()

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

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

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

getLength()

Возвращает число атрибутов.

getNames()

Возвращает список имен атрибутов (ключей отображения).

применимой для использования в объявлении кодировки XML-документа. Установленная кодировка будет проигнорирована синтаксическим анализатором документа, если установлен символьный поток, осуществляющий автоматическое преобразование.

getEncoding()

Возвращает кодировку документа или None, если кодировка неизвестна.

setByteStream( bytefile)

Устанавливает байтовый поток (файловый или подобный объект, не выполняющий преобразование байтов в символы), из которого будет производиться чтение документа. Кодировка потока может быть установлена с помощью метода setEncoding. Байтовый поток не будет использоваться синтаксическим анализатором документа, если установлен символьный поток, осуществляющий автоматическое преобразование байтов (в определенной кодировке) в символы Unicode.

getByteStream()

Возвращает байтовый поток, из которого должно производиться чтение документа. Кодировка этого потока может быть получена с помощью метода getEncoding.

setCharacterStream( charfile)

Устанавливает символьный поток (файловый или подобный объект, осуществляющий автоматическое преобразование байтов в определенной кодировке в символы Unicode), из которого должно производиться чтение документа.

getCharacterStream()

Возвращает символьный поток, из которого должно производиться чтение документа.