Ubuntu Manpage: Class::MakeMethods::Autoload - Declare generated subs with AUTOLOAD

Provided by: libclass-makemethods-perl_1.01-7_all

NAME

       Class::MakeMethods::Autoload - Declare generated subs with AUTOLOAD

SYNOPSIS

         package MyObject;
         use Class::MakeMethods::Autoload 'Standard::Hash::scalar';

         package main;
         my $obj = bless {}, 'MyObject';

         $obj->foo("Foozle");
         print $obj->foo();

DESCRIPTION

       This package provides a generate-on-demand interface to Class::MakeMethods.

       When your class uses this package, it imports an AUTOLOAD function that resolves missing methods by using
       Class::MakeMethods to generate and install a standard type of method.

       You must specify the type of method to be generated by passing a single argument to your use
       Class::MakeMethods::Autoload statement, which can take any of these forms:

       •   A Class::MakeMethods generator name and method type.

           Here are three examples:

             use Class::MakeMethods::Autoload 'Standard::Hash:scalar';

             use Class::MakeMethods::Autoload 'Basic::Universal::no_op';

             use Class::MakeMethods::Autoload
                           '::Class::MakeMethod::Composite::Global:array';

       •   A  reference  to  a  subroutine  which  will  be called for each requested function name and which is
           expected to return the name of the method generator to use.

           Here's a contrived example which generates scalar accessors for methods except those with a digit  in
           their name, which are treated as globals.

             use Class::MakeMethods::Autoload sub {
               my $name = shift;
               ( $name =~ /\d/ ) ? 'Standard::Global::scalar'
                                 : 'Standard::Hash::scalar'
             };

       •   A  reference  to  a  hash  which  defines which method type to use based on the name of the requested
           method. If a key exists which is an exact match for the requested function name, the associated value
           is used; otherwise, each of the keys is used as a regular expression, and the value of the first  one
           that  matches  the  function  name  is used. (For regular expression matching, the keys are tested in
           reverse length order, longest to shortest.)

           Here's an example which provides a new() constructor, a DESTROY() method that  does  nothing,  and  a
           wildcard match that provides scalar accessors for all other Autoloaded methods:

             use Class::MakeMethods::Autoload {
               'new'     => 'Standard::Hash::new',
               '.*'      => 'Standard::Hash::scalar',
               'DESTROY' => 'Standard::Universal::no_op',
             };

           Here's  a  more  sophisticated  example  which  causes all-upper-case method names to be generated as
           globals, those with a leading upper-case letter to be generated  as  inheritable  data  methods,  and
           others to be normal accessors:

             use Class::MakeMethods::Autoload {
               'new'     => 'Standard::Hash::new',
               '.*'      => 'Standard::Hash::scalar',
               '[A-Z].*' => 'Standard::Inheritable::scalar',
               '[A-Z0-9]+' => 'Standard::Global::scalar',
               'DESTROY' => 'Standard::Universal::no_op',
             };

DIAGNOSTICS

       The  following  warnings  and errors may be produced when using Class::MakeMethods::Attribute to generate
       methods. (Note that this list does not include  run-time  messages  produced  by  calling  the  generated
       methods, or the standard messages produced by Class::MakeMethods.)

       No default method type; can't autoload
           You   must   declare   a   default   method   type,   generally   by  passing  its  name  to  a  "use
           Class::MakeMethods::Autoload" statement, prior to autoloading any methods.

       Construction of %s method %s failed to produce usable method
           Indicates that Autoload  successfully  called  Class::MakeMethods->make  to  generate  the  requested
           method,  but  afterwards  was  not  able  to  invoke  the  generated method. You may have selected an
           incompatible method type, or the method may not have been installed successfully.

NAME

SYNOPSIS

DESCRIPTION

DIAGNOSTICS

SEE ALSO