.\" Automatically generated by Pod::Man 2.28 (Pod::Simple 3.28) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is turned on, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{ . if \nF \{ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. . \" fudge factors for nroff and troff .if n \{\ . ds #H 0 . ds #V .8m . ds #F .3m . ds #[ \f1 . ds #] \fP .\} .if t \{\ . ds #H ((1u-(\\\\n(.fu%2u))*.13m) . ds #V .6m . ds #F 0 . ds #[ \& . ds #] \& .\} . \" simple accents for nroff and troff .if n \{\ . ds ' \& . ds ` \& . ds ^ \& . ds , \& . ds ~ ~ . ds / .\} .if t \{\ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' .\} . \" troff and (daisy-wheel) nroff accents .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' .ds 8 \h'\*(#H'\(*b\h'-\*(#H' .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] .ds ae a\h'-(\w'a'u*4/10)'e .ds Ae A\h'-(\w'A'u*4/10)'E . \" corrections for vroff .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' . \" for low resolution devices (crt and lpr) .if \n(.H>23 .if \n(.V>19 \ \{\ . ds : e . ds 8 ss . ds o a . ds d- d\h'-1'\(ga . ds D- D\h'-1'\(hy . ds th \o'bp' . ds Th \o'LP' . ds ae ae . ds Ae AE .\} .rm #[ #] #H #V #F C .\" ======================================================================== .\" .IX Title "MooseX::ArrayRef 3pm" .TH MooseX::ArrayRef 3pm "2014-09-10" "perl v5.20.1" "User Contributed Perl Documentation" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" MooseX::ArrayRef \- blessed arrayrefs with Moose .SH "SYNOPSIS" .IX Header "SYNOPSIS" .Vb 9 \& { \& package Local::Person; \& use Moose; \& has name => ( \& is => \*(Aqro\*(Aq, \& isa => \*(AqStr\*(Aq, \& ); \& _\|_PACKAGE_\|_\->meta\->make_immutable; \& } \& \& { \& package Local::Marriage; \& use MooseX::ArrayRef; \& has husband => ( \& is => \*(Aqro\*(Aq, \& isa => \*(AqLocal::Person\*(Aq, \& ); \& has wife => ( \& is => \*(Aqro\*(Aq, \& isa => \*(AqLocal::Person\*(Aq, \& ); \& _\|_PACKAGE_\|_\->meta\->make_immutable; \& } \& \& my $marriage = Local::Marriage\->new( \& wife => Local::Person\->new(name => \*(AqAlex\*(Aq), \& husband => Local::Person\->new(name => \*(AqSam\*(Aq), \& ); \& \& use Data::Dumper; \& use Scalar::Util qw(reftype); \& print reftype($marriage), "\en"; # \*(AqARRAY\*(Aq \& print Dumper($marriage); .Ve .SH "DESCRIPTION" .IX Header "DESCRIPTION" Objects implemented with arrayrefs rather than hashrefs are often faster than those implemented with hashrefs. Moose's default object implementation is hashref based. Can we go faster? .PP Simply \f(CW\*(C`use MooseX::ArrayRef\*(C'\fR instead of \f(CW\*(C`use Moose\*(C'\fR, but note the limitations in the section below. .PP The current implementation is mostly a proof of concept, but it does mostly seem to work. .SH "BUGS AND LIMITATIONS" .IX Header "BUGS AND LIMITATIONS" .SS "Limitations on Speed" .IX Subsection "Limitations on Speed" The accessors for mutable classes not significantly faster than Moose's traditional hashref-based objects. For immutable classes, the speed up is bigger .PP .Vb 5 \& Rate HashRef_M ArrayRef_M HashRef_I ArrayRef_I \& HashRef_M 1016/s \-\- \-1% \-48% \-55% \& ArrayRef_M 1031/s 1% \-\- \-47% \-54% \& HashRef_I 1953/s 92% 89% \-\- \-13% \& ArrayRef_I 2257/s 122% 119% 16% \-\- .Ve .SS "Limitations on Mutability" .IX Subsection "Limitations on Mutability" Things will probably break if you try to modify classes, add roles, etc \*(L"on the fly\*(R". Make your classes immutable before instantiating even a single object. .SS "Limitations on Inheritance" .IX Subsection "Limitations on Inheritance" Inheritance isn't easy to implement with arrayrefs. The current implementation suffers from the following limitations: .IP "\(bu" 4 Single inheritance only. .Sp You cannot extend multiple parent classes. .IP "\(bu" 4 Inherit from other MooseX::ArrayRef classes only. .Sp A MooseX::ArrayRef class cannot extend a non\-MooseX::ArrayRef class. Even non-Moose classes which are implemented using arrayrefs. (Of course, all Moose classes inherit from Moose::Object too, which is just fine.) .PP Note that delegation (via Moose's \f(CW\*(C`handles\*(C'\fR) is often a good alternative to inheritance. .SS "Issue Tracker" .IX Subsection "Issue Tracker" Please report any bugs to . .SH "SEE ALSO" .IX Header "SEE ALSO" Moose, MooseX::GlobRef, MooseX::InsideOut. .SH "AUTHOR" .IX Header "AUTHOR" Toby Inkster . .SH "COPYRIGHT AND LICENCE" .IX Header "COPYRIGHT AND LICENCE" This software is copyright (c) 2012 by Toby Inkster. .PP This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. .SH "DISCLAIMER OF WARRANTIES" .IX Header "DISCLAIMER OF WARRANTIES" \&\s-1THIS PACKAGE IS PROVIDED \*(L"AS IS\*(R" AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.\s0