$tree = HTML::TreeBuilder->new

Метод new () не принимает параметров. Он возвращает новый, пустой объект HTML::TreeBuilder.

$result = $tree->parse_file ($file)

Метод parse_file () принимает имя файла или дескриптор файла и интерпретирует содержимое, представленное этим файлом, сохраняя дерево в самом объекте HTML::TreeBuilder. Если синтаксический анализ выполнен успешно, результатом работы данного метода является представление объекта дерева, а если возникают какие-либо нарушения (сообщение об ошибке записываются в переменной $!), — значение undef.

$result = $tree->parse($data)

Метод parse () позволяет выполнять синтаксический анализ файла HTML в виде фрагментов произвольного размера. Параметр $data представляет собой скаляр, который содержит обрабаты­ваемый текст HTML. Как правило, метод parse () вызывается неоднократно, и каждый раз ему пе­редается очередной фрагмент обрабатываемого документа. Ниже показано, как воспользоваться этим свойством, чтобы начать синтаксический анализ кода HTML еще во время загрузки файла. Ес­ли в ходе выполнения синтаксического анализа будут обнаружены какие-либо нарушения, метод parse () возвращает значение undef.

$tree->eof

Этот метод вызывается при использовании метода parse(). Он сообщает объекту html::TreeBuilder, что данные больше не будут поступать, и позволяет закончить синтаксиче­ский анализ.

В листинге ниже будет приведен интересный пример использования функций parse () и eof () для синтаксического анализа файла HTML, поступающего построчно со стандартного устройства ввода.