README
1NAME
2 Class::Accessor::Fast::Contained - Fast accessors with data containment
3
4VERSION
5 This document refers to version 1.01 of Class::Accessor::Fast::Contained
6
7SYNOPSIS
8 package Foo;
9 use base qw(Class::Accessor::Fast::Contained);
10
11 # The rest is the same as Class::Accessor::Fast
12
13DESCRIPTION
14 This module does two things differently to the venerable
15 Class::Accessor::Fast :
16
17 * Fields are stored at arms-length within a single hash value of
18 $self, rather than directly in the $self blessed referent.
19
20 * "new()" allows mixin into an existing object, rather than creating
21 and returning a new blessed hashref. To do this, just call something
22 like:
23
24 my $self = Some::Other::Class->new;
25 $self = $self->Class::Accessor::Fast::Contained::new;
26
27 Note that the mixin code only supports objects which use a blessed
28 hash reference or a blessed typeglob reference.
29
30 An alias "setup()" is available which does the same as "new()" but
31 might make more sense if being used in this way.
32
33DEPENDENCIES
34 Other than the standard Perl distribution, you will need the following:
35
36 * Class::Accessor
37
38BUGS
39 If you spot a bug or are experiencing difficulties that are not
40 explained within the documentation, please send an email to
41 oliver@cpan.org or submit a bug to the RT system (http://rt.cpan.org/).
42 It would help greatly if you are able to pinpoint problems or even
43 supply a patch.
44
45SEE ALSO
46 Class::Accessor
47
48AUTHOR
49 Oliver Gorwits "<oliver.gorwits@oucs.ox.ac.uk>"
50
51ACKNOWLEDGEMENTS
52 Thanks to Marty Pauly and Michael G Schwern for Class::Accessor and its
53 tests, which I've shamelessly borrowed for this distribution.
54
55COPYRIGHT & LICENSE
56 Copyright (c) The University of Oxford 2008.
57
58 This library is free software; you can redistribute it and/or modify it
59 under the same terms as Perl itself.
60
61