mac::aete::parser(3) [osx man page]

Mac::AETE::Parser(3)					User Contributed Perl Documentation				      Mac::AETE::Parser(3)

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.

perl v5.10.0							    2006-06-01						      Mac::AETE::Parser(3)

Mac::AETE::App(3)					User Contributed Perl Documentation					 Mac::AETE::App(3)

NAME

       Mac::AETE::App - reads the Macintosh Apple event dictionary from an application.

SYNOPSIS

	    use Mac::AETE::App;
	    use Mac::AETE::Format::Dictionary;

	    $app = App->new("My Application");
	    $formatter = Dictionary->new;
	    $app->set_format($formatter);
	    $app->read;
	    $app->write;

DESCRIPTION

       The App module simplifies reading the Apple event dictionary from an application.  It will launch the application if necessary to obtain
       the dictionary.

       Methods

       new	 Example: ($name is the name of the application.)

		      use Mac::AETE::App;
		      use Mac::AETE::Format::Dictionary;

		      $app = App->new($aete_handle, $name);

       read	 (Inherited from Mac::AETE::Parser.)

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

		      $app->read;

       set_format
		 (Inherited from Mac::AETE::Parser.)

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

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

       copy	 (Inherited from Mac::AETE::Parser.)

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

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

		 copies the suites from $aete2 into $aete.

       merge	 (Inherited from Mac::AETE::Parser.)

		 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);
		      $app->merge($aete3);

       write	 (Inherited from Mac::AETE::Parser.)

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

		      $app->write;

INHERITANCE

       Inherits from Mac::AETE::Parser.

AUTHOR

       David Schooley <dcschooley@mediaone.net>

perl v5.10.0							    2005-05-16							 Mac::AETE::App(3)