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

name.
getValueByQName(qname)
Возвращает значения атрибута по его полному имени qname. Для экземпляров
класса AttributesImpl этот метод эквивалентен методу getValue().
getNameByQName(qname)
Возвращает имя атрибута (строку или кортеж) по его полному имени qname. Для
экземпляров класса AttributesImpl этот метод возвращает свой аргумент без
изменений или генерирует исключение KeyError.
getQNameByName(name)
Возвращает полное имя атрибута с именем name. Для экземпляров класса
AttributesImpl этот метод возвращает свой аргумент без изменений или генерирует исключение KeyError.
getQNames()
Возвращает список полных имен атрибутов. Для экземпляров
AttributesImpl этот метод эквивалентен методу getNames().

29.9

класса

xmllib — обработка XML-документов

Модуль xmllib считается устаревшим — используйте вместо него модуль xml.sax.
Этот модуль определяет класс XMLParser, который может служить в качестве базового
для класса, реализующего обработку размеченного текста в формате XML3 (Extensible
Markup Language, расширяемый язык разметки).

XMLParser([**keyword_args])
Создает и возвращает объект, реализующий обработку текста в формате
XML. В настоящий момент воспринимаются следующие именованные аргументы
(keyword_args):
accept_unquoted_attributes
Если этот аргумент является истиной, обработчик будет воспринимать значения атрибутов, не заключенных в кавычки. По умолчанию равен 0.
accept_missing_endtag_name
Если этот аргумент является истиной, обработчик будет воспринимать закрывающие безымянные теги (‘’). По умолчанию равен 0.
3

http://www.w3.org/TR/REC-xml, http://www.w3.org/XML/

29.9. xmllib — обработка XML-документов

405

map_case
Если этот аргумент является истиной, обработчик будет приводить имена
тегов и атрибутов к нижнему регистру. По умолчанию равен 0.
accept_utf8
Если этот аргумент является истиной, обработчик допускает использование
входной кодировки UTF-8. По умолчанию равен 0.
translate_attribute_references
Если этот аргумент является истиной, обработчик будет заменять ссылки на
символы и сущности в значениях атрибутов. По умолчанию равен 1.
Класс XMLParser имеет следующие интерфейсные атрибуты данных и методы,
которые определяют тип документа (DTD):
attributes
Отображение, в котором в качестве ключей выступают имена элементов и в качестве значений — отображения имен возможных для данного элемента атрибутов
к их значениям по умолчанию (или None, если атрибут не имеет значения по
умолчанию). Вам следует переопределить этот атрибут в производном классе — в
исходной реализации он равен пустому словарю.
elements
Отображение имен элементов к кортежам из функций (или других объектов, поддерживающих вызов), предназначенных для обработки открывающего и закрывающего тега для этого элемента или None, если должен быть вызван метод
unknown_starttag() или unknown_endtag(). Вам следует переопределить
этот атрибут в производном классе — в исходной реализации он равен пустому
словарю.
entitydefs
Отображение имен сущностей к их значениям. В исходной реализации равен словарю, в котором есть записи с ключами ’lt’, ’gt’, ’amp’, ’quot’ и ’apos’
(обязательный набор для всех типов документов).
reset()
Возвращает экземпляр в исходное состояние. Все необработанные данные теряются. Этот метод неявно вызывается при инициализации.
setnomoretags()
Останавливает обработку тегов. Весь последующий текст воспринимается без обработки (CDATA).
setliteral()
Временно приостанавливает обработку тегов. Последующий текст воспринимается
без обработки (CDATA). Обработчик автоматически выходит из этого режима, как
только дойдет до закрывающего тега для последнего открытого.
feed(data)
Передает экземпляру размеченный текст data для обработки. Обрабатываются

406

Глава 29. Средства работы с языками структурной разметки
только завершенные данные, остальное остается в буфере до тех пор, пока не
будет передана следующая порция данных или не будет вызван метод close().

close()
Завершает обработку всех данных в буфере. Вы можете переопределить этот метод
в производном классе, добавив дополнительные действия. Переопределенный метод
всегда должен вызывать исходную версию метода.
translate_references(data)
Преобразует все ссылки на символы (‘&#ref;’) и сущности (‘&ref;’) в строке
data и возвращает полученный текст.
getnamespace()
Возвращает отображение аббревиатур для (активных в настоящий момент) пространств имен к их URI (Uniform Resource Identifier, универсальный идентификатор
ресурса).
handle_xml(encoding, standalone)
Вызывается для обработки тега ‘’. В качестве аргументов --">