NAME

Mac::AETE::Parser - parses Macintosh AETE and AEUT resources.

SYNOPSIS

     use Mac::AETE::Parser;
     use Mac::AETE::Format::Dictionary;

     $aete = Parser->new($aete_handle, $name);
     $formatter = Dictionary->new;
     $aete->set_format($formatter);
     $aete->read;
     $aete->write;

DESCRIPTION

The Parser module serves as a base class for the Mac::AETE::App and Mac::AETE::Dialect modules.

Methods

new

Example: ($aete_handle is a handle containing a valid AETE resource. $name is the name of the application.)

     use Mac::AETE::Parser;
     use Mac::AETE::Format::Dictionary;

     $aete = Parser->new($aete_handle, $name);

read

Reads the data contained in the AETE resource or handle. Example:

     $aete->read;

set_format

Sets the output formatter used during by the 'write' subroutine. Example:

     $formatter = Dictionary->new;
     $aete->set_format($formatter);

copy

Copies all suites from one Parser object into another. Example:

     $aete2 = Parser->new($aete_handle2, $another_name);
     $aete->copy($aete2);

copies the suites from $aete2 into $aete.

merge

Merges suites from one Parser object into another. Only the suites that exist in both objects will be replaced. Example:

     $aete3 = Parser->new($aete_handle2, $another_name);
     $aete->merge($aete3);

write

Prints the contents of the AETE or AEUT resource using the current formatter.

     $aete->write;

INHERITANCE

Parser does not inherit from any other modules.

AUTHOR

David Schooley <dcschooley@mediaone.net>

The data structures are adapted from modifications made to the original aeteconvert script by Chris Nandor.