GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  CLASS::ACCESSOR::LITE (3)

.ds Aq ’

NAME

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

CONTENTS

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 read-only accessor for the name of the properties passed through as an arrayref
wo => \@name_of_the_properties creates a write-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 CWClass::Accessor::Lite in an inherited module?

Yes in most cases, when the class object in the super class is implemented 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.
Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 CLASS::ACCESSOR::LITE (3) 2015-05-05

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.