В современном API-интерфейсе, который был введен в версии 3.0 данного модуля, для установки обработчиков событий, эформленных в виде процедур обратного вызова, вызывается метод handler (). До сих пор можно встретить код, в котором используется более ранний API-интерфейс, и разработчикам модуля HTML::Parser приходится обеспечивать совместимость с устаревшим API-интерфейсом. Однако в этом разделе будут рассмот­рены только наиболее часто применяемые компоненты API-интерфейса версии С дополнительной информацией о том, как управлять многочисленными опциями этого модуля, можно ознакомиться в документации POD HTML::Parser.

Для создания нового синтаксического анализатора необходимо вызвать метод HTML::Parser->new ().

$parser = HTML::Parser->new(@options)

Метод new() создает новый объект HTML::Parser. Параметр @options представляет собой ряд пар “опция/значение”, которые позволяют изменить различные установки синтаксического ана­лизатора. Чаще всего применяется опция api_version, которая может принимать значение “2” для создания синтаксического анализатора версии 2 или значение “3” — для создания синтаксического анализатора версии 3. Для обеспечения обратной совместимости предусмотрено создание методом new () синтаксического анализатора версии 2, если эта опция не указана.

После создания синтаксического анализатора необходимо вызвать метод handler () один или несколько раз для установки обработчиков событий.

$parser->handler($event => &handler,$args)

Метод handler ( ) устанавливает обработчик события, возникающего в процессе синтаксическое го анализа. Параметр $event указывает имя события, &handler содержит ссылку на подпрограмму обратного вызова для его обработки, а параметр $args представляет собой строку, сообщающую модулю html::Parser, какая информация о событии должна передаваться в подпрограмму.