/usr/share/perl5/Class/Gomor/Array.pm is in libclass-gomor-perl 1.02-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 | #
# $Id: Array.pm 1633 2009-05-23 13:30:33Z gomor $
#
package Class::Gomor::Array;
use strict; use warnings;
our $VERSION = '1.02';
use Class::Gomor;
use base qw(Class::Gomor);
use Data::Dumper;
no strict 'refs';
sub new {
my $self = shift;
my $class = ref($self) || $self;
my %h = @_;
$class->cgCheckParams(\%h, $class->cgGetAttributes)
unless $Class::Gomor::NoCheck;
my @obj;
my $base = $class.'::__';
$obj[${$base.$_}] = $h{$_} for keys %h;
bless(\@obj, $class);
}
sub cgGetIndice {
my $self = shift;
${(ref($self) || $self).'::__'.shift()};
}
sub cgBuildIndices {
my $self = shift;
my $i = 0;
${(ref($self) || $self).'::__'.$_} = $i++ for @{$self->cgGetAttributes};
}
sub cgFullClone {
my $self = shift;
my ($n) = @_;
return $self->SUPER::cgFullClone($n) if $n;
my $class = ref($self) || $self;
my @new;
for (@$self) {
(ref($_) && UNIVERSAL::isa($_, 'Class::Gomor'))
? push @new, $_->cgFullClone
: push @new, $_;
}
bless(\@new, $class);
}
sub cgDumper {
my $self = shift;
my $class = ref($self) || $self;
my %h = map { $_ => $self->[$self->cgGetIndice($_)] }
@{$class->cgGetAttributes};
Dumper(\%h);
}
sub _cgAccessorScalar {
my $self = shift;
my $a = shift;
@_ ? $self->[${ref($self).'::__'.$a}] = shift
: $self->[${ref($self).'::__'.$a}];
}
sub _cgAccessorArray {
my $self = shift;
my $a = shift;
@_ ? $self->[${ref($self).'::__'.$a}] = shift
: @{$self->[${ref($self).'::__'.$a}]};
}
1;
=head1 NAME
Class::Gomor::Array - class and object builder, array version
=head1 SYNPOSIS
# Create a base class in BaseClass.pm
package My::BaseClass;
require Class::Gomor::Array;
our @ISA = qw(Class::Gomor::Array);
our @AS = qw(attribute1 attribute2);
our @AA = qw(attribute3 attribute4);
our @AO = qw(other);
# You should initialize yourself array attributes
sub new { shift->SUPER::new(attribute3 => [], attribute4 => [], @_) }
# Create indices and accessors
My::BaseClass->cgBuildIndices;
My::BaseClass->cgBuildAccessorsScalar(\@AS);
My::BaseClass->cgBuildAccessorsArray(\@AA);
sub other {
my $self = shift;
@_ ? $self->[$self->cgGetIndice('other')] = [ split(/\n/, shift) ]
: @{$self->[$self->cgGetIndice('other')]};
}
1;
# Create a subclass in SubClass.pm
package My::SubClass;
require My::BaseClass;
our @ISA = qw(My::BaseClass);
our @AS = qw(subclassAttribute);
My::SubClass->cgBuildIndices;
My::SubClass->cgBuildAccessorsScalar(\@AS);
sub new {
shift->SUPER::new(
attribute1 => 'val1',
attribute2 => 'val2',
attribute3 => [ 'val3', ],
attribute4 => [ 'val4', ],
other => [ 'none', ],
subclassAttribute => 'subVal',
);
}
1;
# A program using those classes
my $new = My::SubClass->new;
my $val1 = $new->attribute1;
my @values3 = $new->attribute3;
my @otherOld = $new->other;
$new->other("str1\nstr2\nstr3");
my @otherNew = $new->other;
print "@otherNew\n";
$new->attribute2('newValue');
$new->attribute4([ 'newVal1', 'newVal2', ]);
=head1 DESCRIPTION
This class is a subclass from B<Class::Gomor>. It implements objects as array references, and inherits methods from B<Class::Gomor>.
=head1 GLOBAL VARIABLES
See B<Class::Gomor>.
=head1 METHODS
=over 4
=item B<new> (hash)
Object constructor. This is where user passed attributes (hash argument) are checked against valid attributes (gathered by B<cgGetAttributes> method). Valid attributes are those that exists (doh!), and have not an undef value. The default is to check this, you can avoid it by setting B<$NoCheck> global variable (see perldoc B<Class::Gomor>).
=item B<cgBuildIndices>
You MUST call this method one time at the beginning of your classes, and all subclasses (even if you do not add new attributes). It will build the matching between object attributes and their indices inside the array object. Global variables will be created in your class, with the following format: B<$__attributeName>.
=item B<cgBuildAccessorsScalar> (array ref)
=item B<cgBuildAccessorsArray> (array ref)
See B<Class::Gomor>.
=item B<cgGetIndice> (scalar)
Returns the array indice of specified attribute passed as a parameter. You can use it in your programs to avoid calling directly the global variable giving indice information concerning requesting object, thus avoiding using `no strict 'vars';'. This method is usually used when you build your own accessors (those using attributes defined in B<@AO>).
=item B<cgClone> [ (scalar) ]
You can clone one of your objects by calling this method. An optional parameter may be used to create multiple clones. Cloning will occure only on the first level attributes, that is, if you have attributes containing other objects, they will not be cloned.
=item B<cgFullClone> [ (scalar) ]
This method is the same as B<cgClone>, but will clone all attributes recursively, but only if they are subclassed from B<Class::Gomor>. So, objects created with other modules than B<Class::Gomor::Array> or B<Class::Gomor::Hash> will not be cloned.
Another thing to note, there is no catch for cycling references (when you link two objects with each others). You have been warned.
=item B<cgDumper>
Will return a string as with B<Data::Dumper> Dumper method. This is useful for debugging purposes, because an arrayref object does not include attributes names.
=back
=head1 SEE ALSO
L<Class::Gomor>
=head1 AUTHOR
Patrice E<lt>GomoRE<gt> Auffret
=head1 COPYRIGHT AND LICENSE
Copyright (c) 2004-2009, Patrice E<lt>GomoRE<gt> Auffret
You may distribute this module under the terms of the Artistic license.
See LICENSE.Artistic file in the source distribution archive.
=cut
|