NAME

       Class::Accessor::Lite - a minimalistic variant of Class::Accessor

SYNOPSIS

           package MyPackage;

           use Class::Accessor::Lite (
               new => 1,
               rw  => [ qw(foo bar) ],
               ro  => [ qw(baz) ],
               wo  => [ qw(hoge) ],
           );

DESCRIPTION

       The module is a variant of "Class::Accessor".  It is fast and requires less typing, has no dependencies
       to other modules, and does not mess up the @ISA.

THE USE STATEMENT

       The use statement (i.e. the "import" function) of the module takes a single hash as an argument that
       specifies the types and the names of the properties.  Recognises the following keys.

       new => $true_or_false
           the  default  constructor  is  created if the value evaluates to true, otherwise nothing is done (the
           default behaviour)

       rw => \@name_of_the_properties
           creates a read / write accessor for the name of the properties passed through as an arrayref

       ro => \@name_of_the_properties
           creates a write-only accessor for the name of the properties passed through as an arrayref

       rw => \@name_of_the_properties
           creates a read-only accessor for the name of the properties passed through as an arrayref

       For more detailed explanation read the following section describing the behaviour of each  function  that
       actually creates the accessors.

FUNCTIONS

       As  of  version  0.04  the properties can be specified as the arguments to the "use" statement (as can be
       seen in the SYNOPSIS) which is now the recommended way of using the module,  but  for  compatibility  the
       following functions are provided as well.

   Class::Accessor::Lite->mk_accessors(@name_of_the_properties)
       Creates  an  accessor  in  current  package  under  the  name  specified by the arguments that access the
       properties (of a hashref) with the same name.

   Class::Accessor::Lite->mk_ro_accessors(@name_of_the_properties)
       Same as mk_accessors() except it will generate read-only accessors (i.e. true accessors).  If you attempt
       to set a value with these accessors it will throw an exception.

   Class::Accessor::Lite->mk_wo_accessors(@name_of_the_properties)
       Same as mk_accessors() except it will generate write-only accessors (i.e. mutators).  If you  attempt  to
       read a value with these accessors it will throw an exception.

   Class::Accessor::Lite->mk_new()
       Creates the "new" function that accepts a hash or a hashref as the initial properties of the object.

   Class::Accessor::Lite->mk_new_and_accessors(@name_of_the_properties)
       DEPRECATED.  Use the new "use Class::Accessor::Lite (...)" style.

FAQ

   Can I use "Class::Accessor::Lite" in an inherited module?
       Yes  in  most cases, when the class object in the super class is implemeted using a hashref.  However you
       _should_ _not_ create the constructor for the inherited class by  calling  "Class::Accessor::Lite-"new()>
       or  by  "use Class::Accessor::Lite (new =" 1).  The only other thing that "Class::Accessor::Lite" does is
       to set up the accessor functions for given property names through a blessed hashref.

   What happens when passing more than one arguments to the accessor?
       When the accessor built by Class::Accessor::Lite is given more than one arguments,  a  reference  to  the
       arguments  will  be saved as an arrayref.  This behaviour might not be necessary but is implemented as is
       to maintain compatibility with Class::Accessor::Fast.

           my @data = (1, 2, 3);
           $obj->someproperty(@data);

           $obj->someproperty->[2]++; # $data[3] is incremented

       In general, you should pass an arrayref to set an arrayref to a property.

           my @data = (1, 2, 3);
           $obj->someproperty([ @data ]); # save a copy using arrayref

           $obj->someproper->[2]++; # @data is not modified

SEE ALSO

       Class::Accessor

       Class::Accessor::Lite

AUTHORS

       Copyright (C) 2008 - 2010 Kazuho Oku

LICENSE

       This library is free software; you can redistribute it and/or modify it under  the  same  terms  as  Perl
       itself, either Perl version 5.8.6 or, at your option, any later version of Perl 5 you may have available.

perl v5.14.2                                       2010-12-06                         Class::Accessor::Lite(3pm)