| 1 | package App::Framework::Lite::Object ; | ||||||||||||||||||||||||||||
| 2 | |||||||||||||||||||||||||||||
| 3 | =head1 NAME | ||||||||||||||||||||||||||||
| 4 | |||||||||||||||||||||||||||||
| 5 | Object - Basic object | ||||||||||||||||||||||||||||
| 6 | |||||||||||||||||||||||||||||
| 7 | =head1 SYNOPSIS | ||||||||||||||||||||||||||||
| 8 | |||||||||||||||||||||||||||||
| 9 | use App::Framework::Lite::Object ; | ||||||||||||||||||||||||||||
| 10 | |||||||||||||||||||||||||||||
| 11 | |||||||||||||||||||||||||||||
| 12 | =head1 DESCRIPTION | ||||||||||||||||||||||||||||
| 13 | |||||||||||||||||||||||||||||
| 14 | |||||||||||||||||||||||||||||
| 15 | =head1 DIAGNOSTICS | ||||||||||||||||||||||||||||
| 16 | |||||||||||||||||||||||||||||
| 17 | Setting the debug flag to level 1 prints out (to STDOUT) some debug messages, setting it to level 2 prints out more verbose messages. | ||||||||||||||||||||||||||||
| 18 | |||||||||||||||||||||||||||||
| 19 | =head1 AUTHOR | ||||||||||||||||||||||||||||
| 20 | |||||||||||||||||||||||||||||
| 21 | Steve Price C<< <sdprice at cpan.org> >> | ||||||||||||||||||||||||||||
| 22 | |||||||||||||||||||||||||||||
| 23 | =head1 BUGS | ||||||||||||||||||||||||||||
| 24 | |||||||||||||||||||||||||||||
| 25 | None that I know of! | ||||||||||||||||||||||||||||
| 26 | |||||||||||||||||||||||||||||
| 27 | =head1 INTERFACE | ||||||||||||||||||||||||||||
| 28 | |||||||||||||||||||||||||||||
| 29 | =over 4 | ||||||||||||||||||||||||||||
| 30 | |||||||||||||||||||||||||||||
| 31 | =cut | ||||||||||||||||||||||||||||
| 32 | |||||||||||||||||||||||||||||
| 33 | 7 | ▶ | use strict ; | ||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||
| 34 | 7 | ▶ | use Carp ; | ||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||
| 35 | 7 | ▶ | use Cwd ; | ||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||
| 36 | |||||||||||||||||||||||||||||
| 37 | 7 | our $VERSION = "2.002" ; | |||||||||||||||||||||||||||
| 38 | 7 | our $AUTOLOAD ; | |||||||||||||||||||||||||||
| 39 | |||||||||||||||||||||||||||||
| 40 | #============================================================================================ | ||||||||||||||||||||||||||||
| 41 | # USES | ||||||||||||||||||||||||||||
| 42 | #============================================================================================ | ||||||||||||||||||||||||||||
| 43 | |||||||||||||||||||||||||||||
| 44 | |||||||||||||||||||||||||||||
| 45 | #============================================================================================ | ||||||||||||||||||||||||||||
| 46 | # GLOBALS | ||||||||||||||||||||||||||||
| 47 | #============================================================================================ | ||||||||||||||||||||||||||||
| 48 | 7 | my $global_debug = 0 ; | |||||||||||||||||||||||||||
| 49 | 7 | my $global_verbose = 0 ; | |||||||||||||||||||||||||||
| 50 | 7 | my $strict_fields = 0 ; | |||||||||||||||||||||||||||
| 51 | |||||||||||||||||||||||||||||
| 52 | 7 | my @SPECIAL_FIELDS = qw/ | |||||||||||||||||||||||||||
| 53 | global_debug | ||||||||||||||||||||||||||||
| 54 | global_verbose | ||||||||||||||||||||||||||||
| 55 | strict_fields | ||||||||||||||||||||||||||||
| 56 | / ; | ||||||||||||||||||||||||||||
| 57 | |||||||||||||||||||||||||||||
| 58 | 7 | my %COMMON_FIELDS = ( | |||||||||||||||||||||||||||
| 59 | 'debug' => undef, # pseudo field | ||||||||||||||||||||||||||||
| 60 | 'verbose' => undef, # pseudo field | ||||||||||||||||||||||||||||
| 61 | ) ; | ||||||||||||||||||||||||||||
| 62 | |||||||||||||||||||||||||||||
| 63 | # Constant | ||||||||||||||||||||||||||||
| 64 | #my @REQ_LIST ; | ||||||||||||||||||||||||||||
| 65 | 7 | my %FIELD_LIST ; | |||||||||||||||||||||||||||
| 66 | |||||||||||||||||||||||||||||
| 67 | my %CLASS_INIT; | ||||||||||||||||||||||||||||
| 68 | 7 | my %CLASS_INSTANCE ; | |||||||||||||||||||||||||||
| 69 | |||||||||||||||||||||||||||||
| 70 | 7 | my %DEBUG ; | |||||||||||||||||||||||||||
| 71 | 7 | my %VERBOSE ; | |||||||||||||||||||||||||||
| 72 | |||||||||||||||||||||||||||||
| 73 | #============================================================================================ | ||||||||||||||||||||||||||||
| 74 | # CONSTRUCTOR | ||||||||||||||||||||||||||||
| 75 | #============================================================================================ | ||||||||||||||||||||||||||||
| 76 | |||||||||||||||||||||||||||||
| 77 | =item B<new([%args])> | ||||||||||||||||||||||||||||
| 78 | |||||||||||||||||||||||||||||
| 79 | Create a new object. | ||||||||||||||||||||||||||||
| 80 | |||||||||||||||||||||||||||||
| 81 | The %args are specified as they would be in the B<set> method, for example: | ||||||||||||||||||||||||||||
| 82 | |||||||||||||||||||||||||||||
| 83 | 'mmap_handler' => $mmap_handler | ||||||||||||||||||||||||||||
| 84 | |||||||||||||||||||||||||||||
| 85 | Special arguments are: | ||||||||||||||||||||||||||||
| 86 | |||||||||||||||||||||||||||||
| 87 | 'fields' => Either ARRAY list of valid field names, or HASH of field names with default values | ||||||||||||||||||||||||||||
| 88 | |||||||||||||||||||||||||||||
| 89 | Example: | ||||||||||||||||||||||||||||
| 90 | |||||||||||||||||||||||||||||
| 91 | new( | ||||||||||||||||||||||||||||
| 92 | 'fields' => { | ||||||||||||||||||||||||||||
| 93 | 'cmd' => undef, | ||||||||||||||||||||||||||||
| 94 | 'status' => 0, | ||||||||||||||||||||||||||||
| 95 | 'results' => [], | ||||||||||||||||||||||||||||
| 96 | |||||||||||||||||||||||||||||
| 97 | ) | ||||||||||||||||||||||||||||
| 98 | ) | ||||||||||||||||||||||||||||
| 99 | |||||||||||||||||||||||||||||
| 100 | All defined fields have an accessor method created. | ||||||||||||||||||||||||||||
| 101 | |||||||||||||||||||||||||||||
| 102 | =cut | ||||||||||||||||||||||||||||
| 103 | |||||||||||||||||||||||||||||
| 104 | sub new | ||||||||||||||||||||||||||||
| 105 | 2 | ▶ | { | ||||||||||||||||||||||||||
|
Subroutine
new: called CC=3 SCAR=11.3
Pod
documented
| |||||||||||||||||||||||||||||
| 106 | 2 | my ($obj, %args) = @_ ; | |||||||||||||||||||||||||||
| 107 | |||||||||||||||||||||||||||||
| 108 | 2 | ▶ | my $class = ref($obj) || $obj ; | ||||||||||||||||||||||||||
|
Condition33%1/3
ref $obj || $obj
MC/DC0%0/2
ref $obj || $obj
ref $obj
$obj
Truth table33%1/3
A || B
A= ref $objB= $obj
| |||||||||||||||||||||||||||||
| 109 | #my $class = $obj->class() ; | ||||||||||||||||||||||||||||
| 110 | |||||||||||||||||||||||||||||
| 111 | 2 | ▶ | print "== Object: Creating new $class object ========\n" if $global_debug ; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 112 | # prt_data("ARGS=", \%args, "\n") if $global_debug>=2 ; | ||||||||||||||||||||||||||||
| 113 | |||||||||||||||||||||||||||||
| 114 | # Initialise class variables | ||||||||||||||||||||||||||||
| 115 | 2 | $class->init_class(%args); | |||||||||||||||||||||||||||
| 116 | |||||||||||||||||||||||||||||
| 117 | # Create object | ||||||||||||||||||||||||||||
| 118 | 2 | my $this = {} ; | |||||||||||||||||||||||||||
| 119 | 2 | bless ($this, $class) ; | |||||||||||||||||||||||||||
| 120 | |||||||||||||||||||||||||||||
| 121 | # Initialise object | ||||||||||||||||||||||||||||
| 122 | 2 | $this->init(%args) ; | |||||||||||||||||||||||||||
| 123 | |||||||||||||||||||||||||||||
| 124 | # # Check for required settings | ||||||||||||||||||||||||||||
| 125 | # foreach (@REQ_LIST) | ||||||||||||||||||||||||||||
| 126 | # { | ||||||||||||||||||||||||||||
| 127 | # do | ||||||||||||||||||||||||||||
| 128 | # { | ||||||||||||||||||||||||||||
| 129 | # croak "ERROR: $class : Must specify setting for $_" ; | ||||||||||||||||||||||||||||
| 130 | # } unless defined($this->{$_}) ; | ||||||||||||||||||||||||||||
| 131 | # } | ||||||||||||||||||||||||||||
| 132 | |||||||||||||||||||||||||||||
| 133 | # prt_data("== Created object=", $this, "================================================\n") if $global_debug ; | ||||||||||||||||||||||||||||
| 134 | |||||||||||||||||||||||||||||
| 135 | 2 | return($this) ; | |||||||||||||||||||||||||||
| 136 | } | ||||||||||||||||||||||||||||
| 137 | |||||||||||||||||||||||||||||
| 138 | #----------------------------------------------------------------------------- | ||||||||||||||||||||||||||||
| 139 | |||||||||||||||||||||||||||||
| 140 | =item B<init([%args])> | ||||||||||||||||||||||||||||
| 141 | |||||||||||||||||||||||||||||
| 142 | Initialises the newly created object instance. | ||||||||||||||||||||||||||||
| 143 | |||||||||||||||||||||||||||||
| 144 | |||||||||||||||||||||||||||||
| 145 | =cut | ||||||||||||||||||||||||||||
| 146 | |||||||||||||||||||||||||||||
| 147 | sub init | ||||||||||||||||||||||||||||
| 148 | 2 | ▶ | { | ||||||||||||||||||||||||||
|
Subroutine
init: called CC=9 SCAR=22.7
Pod
documented
| |||||||||||||||||||||||||||||
| 149 | 2 | my $this = shift ; | |||||||||||||||||||||||||||
| 150 | 2 | my (%args) = @_ ; | |||||||||||||||||||||||||||
| 151 | |||||||||||||||||||||||||||||
| 152 | # prt_data("init() ARGS=", \%args, "\n") if $global_debug>=3 ; | ||||||||||||||||||||||||||||
| 153 | |||||||||||||||||||||||||||||
| 154 | #my $class = $this->class() ; | ||||||||||||||||||||||||||||
| 155 | ##my $class = ref($this) || $this ; | ||||||||||||||||||||||||||||
| 156 | 2 | $this = $this->check_instance() ; | |||||||||||||||||||||||||||
| 157 | |||||||||||||||||||||||||||||
| 158 | # Defaults | ||||||||||||||||||||||||||||
| 159 | ## my %field_list = $this->field_list() ; | ||||||||||||||||||||||||||||
| 160 | 2 | ▶ | my $class = ref($this) || $this ; | ||||||||||||||||||||||||||
|
Condition33%1/3
ref $this || $this
MC/DC0%0/2
ref $this || $this
ref $this
$this
Truth table33%1/3
A || B
A= ref $thisB= $this
| |||||||||||||||||||||||||||||
| 161 | 2 | my %field_list = (); | |||||||||||||||||||||||||||
| 162 | 2 | ▶ | %field_list = %{ $FIELD_LIST{$class} } if exists($FIELD_LIST{$class}) ; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 163 | |||||||||||||||||||||||||||||
| 164 | |||||||||||||||||||||||||||||
| 165 | # May have default value for some or all fields | ||||||||||||||||||||||||||||
| 166 | 2 | my %field_copy ; | |||||||||||||||||||||||||||
| 167 | 2 | foreach my $fld (keys %field_list) | |||||||||||||||||||||||||||
| 168 | { | ||||||||||||||||||||||||||||
| 169 | 12 | my $val = $field_list{$fld} ; | |||||||||||||||||||||||||||
| 170 | |||||||||||||||||||||||||||||
| 171 | # If value is an ARRAY ref or a HASH ref then we want a new copy of this per instance (otherwise | ||||||||||||||||||||||||||||
| 172 | # all instances will have a ref to the same HASH/ARRAY and one instance will change all instance's values!) | ||||||||||||||||||||||||||||
| 173 | 12 | ▶ | if (ref($val) eq 'ARRAY') | ||||||||||||||||||||||||||
|
Branch: 2 branches
| |||||||||||||||||||||||||||||
| 174 | { | ||||||||||||||||||||||||||||
| 175 | 2 | $val = [@$val] ; | |||||||||||||||||||||||||||
| 176 | } | ||||||||||||||||||||||||||||
| 177 | elsif (ref($val) eq 'HASH') | ||||||||||||||||||||||||||||
| 178 | { | ||||||||||||||||||||||||||||
| 179 | 2 | $val = { (%$val) } ; | |||||||||||||||||||||||||||
| 180 | } | ||||||||||||||||||||||||||||
| 181 | |||||||||||||||||||||||||||||
| 182 | 12 | $field_copy{$fld} = $val ; | |||||||||||||||||||||||||||
| 183 | } | ||||||||||||||||||||||||||||
| 184 | |||||||||||||||||||||||||||||
| 185 | 2 | $this->set(%field_copy) ; | |||||||||||||||||||||||||||
| 186 | |||||||||||||||||||||||||||||
| 187 | ## Handle special fields | ||||||||||||||||||||||||||||
| 188 | 2 | foreach my $special (@SPECIAL_FIELDS) | |||||||||||||||||||||||||||
| 189 | { | ||||||||||||||||||||||||||||
| 190 | 6 | ▶ | if (exists($args{$special})) | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 191 | { | ||||||||||||||||||||||||||||
| 192 | # remove from args list | ||||||||||||||||||||||||||||
| 193 | 0 | my $special_val = delete $args{$special} ; | |||||||||||||||||||||||||||
| 194 | |||||||||||||||||||||||||||||
| 195 | # call variable handler | ||||||||||||||||||||||||||||
| 196 | 0 | $this->$special($special_val) ; | |||||||||||||||||||||||||||
| 197 | } | ||||||||||||||||||||||||||||
| 198 | } | ||||||||||||||||||||||||||||
| 199 | |||||||||||||||||||||||||||||
| 200 | ## Set fields from parameters | ||||||||||||||||||||||||||||
| 201 | 2 | $this->set(%args) ; | |||||||||||||||||||||||||||
| 202 | |||||||||||||||||||||||||||||
| 203 | 2 | ▶ | print "init() - done\n" if $global_debug>=3 ; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 204 | |||||||||||||||||||||||||||||
| 205 | } | ||||||||||||||||||||||||||||
| 206 | |||||||||||||||||||||||||||||
| 207 | #----------------------------------------------------------------------------- | ||||||||||||||||||||||||||||
| 208 | |||||||||||||||||||||||||||||
| 209 | =item B<init_class([%args])> | ||||||||||||||||||||||||||||
| 210 | |||||||||||||||||||||||||||||
| 211 | Initialises the object class variables. | ||||||||||||||||||||||||||||
| 212 | |||||||||||||||||||||||||||||
| 213 | |||||||||||||||||||||||||||||
| 214 | =cut | ||||||||||||||||||||||||||||
| 215 | |||||||||||||||||||||||||||||
| 216 | sub init_class | ||||||||||||||||||||||||||||
| 217 | 2 | ▶ | { | ||||||||||||||||||||||||||
|
Subroutine
init_class: called CC=13 SCAR=27.6
Pod
documented
| |||||||||||||||||||||||||||||
| 218 | 2 | my $this = shift ; | |||||||||||||||||||||||||||
| 219 | 2 | my (%args) = @_ ; | |||||||||||||||||||||||||||
| 220 | |||||||||||||||||||||||||||||
| 221 | #my $class = $this->class() ; | ||||||||||||||||||||||||||||
| 222 | 2 | ▶ | my $class = ref($this) || $this ; | ||||||||||||||||||||||||||
|
Condition33%1/3
ref $this || $this
MC/DC0%0/2
ref $this || $this
ref $this
$this
Truth table33%1/3
A || B
A= ref $thisB= $this
| |||||||||||||||||||||||||||||
| 223 | |||||||||||||||||||||||||||||
| 224 | # prt_data("init_class() ARGS=", \%args, "\n") if $global_debug>=3 ; | ||||||||||||||||||||||||||||
| 225 | #prt_data("init_class() ARGS (LIST)=", \@_, "\n") ; | ||||||||||||||||||||||||||||
| 226 | |||||||||||||||||||||||||||||
| 227 | 2 | ▶ | if (!$CLASS_INIT{$class}) | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 228 | { | ||||||||||||||||||||||||||||
| 229 | # Field list | ||||||||||||||||||||||||||||
| 230 | 1 | $FIELD_LIST{$class} = {}; | |||||||||||||||||||||||||||
| 231 | 1 | my $fields = delete($args{'fields'}) ; | |||||||||||||||||||||||||||
| 232 | |||||||||||||||||||||||||||||
| 233 | # prt_data(" + fields=$fields", $fields, "ARGS=", \%args, "\n") if $global_debug>=4 ; | ||||||||||||||||||||||||||||
| 234 | #prt_data(" init_class($class) FIELDS=", $fields, "\n") ; | ||||||||||||||||||||||||||||
| 235 | |||||||||||||||||||||||||||||
| 236 | 1 | ▶ | if ($fields) | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 237 | { | ||||||||||||||||||||||||||||
| 238 | 1 | ▶ | print " + fields=$fields ref()=", ref($fields), "\n" if $global_debug>=4 ; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 239 | |||||||||||||||||||||||||||||
| 240 | 1 | my $class_fields_href = {} ; | |||||||||||||||||||||||||||
| 241 | |||||||||||||||||||||||||||||
| 242 | ## Do the fields | ||||||||||||||||||||||||||||
| 243 | 1 | ▶ | if (ref($fields) eq 'ARRAY') | ||||||||||||||||||||||||||
|
Branch: 2 branches
| |||||||||||||||||||||||||||||
| 244 | { | ||||||||||||||||||||||||||||
| 245 | $class_fields_href = { | ||||||||||||||||||||||||||||
| 246 | (%COMMON_FIELDS), | ||||||||||||||||||||||||||||
| 247 | 0 | map {$_ => undef} @$fields | |||||||||||||||||||||||||||
| 248 | } ; | ||||||||||||||||||||||||||||
| 249 | } | ||||||||||||||||||||||||||||
| 250 | elsif (ref($fields) eq 'HASH') | ||||||||||||||||||||||||||||
| 251 | { | ||||||||||||||||||||||||||||
| 252 | 1 | $class_fields_href = { | |||||||||||||||||||||||||||
| 253 | (%COMMON_FIELDS), | ||||||||||||||||||||||||||||
| 254 | (%$fields) | ||||||||||||||||||||||||||||
| 255 | } ; | ||||||||||||||||||||||||||||
| 256 | } | ||||||||||||||||||||||||||||
| 257 | else | ||||||||||||||||||||||||||||
| 258 | { | ||||||||||||||||||||||||||||
| 259 | 0 | $class_fields_href = { | |||||||||||||||||||||||||||
| 260 | (%COMMON_FIELDS), | ||||||||||||||||||||||||||||
| 261 | ($fields => undef) | ||||||||||||||||||||||||||||
| 262 | } ; | ||||||||||||||||||||||||||||
| 263 | } | ||||||||||||||||||||||||||||
| 264 | |||||||||||||||||||||||||||||
| 265 | 1 | $FIELD_LIST{$class} = $class_fields_href ; | |||||||||||||||||||||||||||
| 266 | } | ||||||||||||||||||||||||||||
| 267 | |||||||||||||||||||||||||||||
| 268 | # create accessors | ||||||||||||||||||||||||||||
| 269 | 1 | my $code = "package $class;\n" ; | |||||||||||||||||||||||||||
| 270 | 1 | foreach my $field (keys %{$FIELD_LIST{$class}}) | |||||||||||||||||||||||||||
| 271 | { | ||||||||||||||||||||||||||||
| 272 | 6 | ▶ | if (!$class->can($field)) | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 273 | { | ||||||||||||||||||||||||||||
| 274 | 4 | $code .= qq{ | |||||||||||||||||||||||||||
| 275 | ## get / set | ||||||||||||||||||||||||||||
| 276 | sub $field | ||||||||||||||||||||||||||||
| 277 | { | ||||||||||||||||||||||||||||
| 278 | my \$this = shift ; | ||||||||||||||||||||||||||||
| 279 | \@_ ? \$this->{$field} = \$_[0] # set | ||||||||||||||||||||||||||||
| 280 | : \$this->{$field}; # get | ||||||||||||||||||||||||||||
| 281 | } | ||||||||||||||||||||||||||||
| 282 | }; | ||||||||||||||||||||||||||||
| 283 | } | ||||||||||||||||||||||||||||
| 284 | |||||||||||||||||||||||||||||
| 285 | 6 | ▶ | if (!$class->can("undef_$field")) | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 286 | { | ||||||||||||||||||||||||||||
| 287 | 4 | $code .= qq{ | |||||||||||||||||||||||||||
| 288 | ## undefine | ||||||||||||||||||||||||||||
| 289 | sub undef_$field | ||||||||||||||||||||||||||||
| 290 | { | ||||||||||||||||||||||||||||
| 291 | my \$this = shift ; | ||||||||||||||||||||||||||||
| 292 | |||||||||||||||||||||||||||||
| 293 | \$this->{$field} = undef ; | ||||||||||||||||||||||||||||
| 294 | } | ||||||||||||||||||||||||||||
| 295 | }; | ||||||||||||||||||||||||||||
| 296 | } | ||||||||||||||||||||||||||||
| 297 | } | ||||||||||||||||||||||||||||
| 298 | |||||||||||||||||||||||||||||
| 299 | 1 | ▶ | print "Created Accessors:\n$code\n" if $global_debug>=4 ; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 300 | |||||||||||||||||||||||||||||
| 301 | 0 | ▶ | eval $code; | ||||||||||||||||||||||||||
|
Subroutine
array: called CC=2 SCAR=7.2
Subroutine
hash: called CC=2 SCAR=7.2
Subroutine
notdef: called CC=2 SCAR=7.2
Subroutine
string: called CC=2 SCAR=7.2
Subroutine
undef_array: not called CC=1 SCAR=0.1
Subroutine
undef_hash: not called CC=1 SCAR=0.1
Subroutine
undef_notdef: called CC=1 SCAR=0.1
Subroutine
undef_string: not called CC=1 SCAR=0.1
Pod
undocumented
Pod
undocumented
Pod
undocumented
Pod
undocumented
Pod
undocumented
Pod
undocumented
Pod
undocumented
Pod
undocumented
Branch: 4 branches
| |||||||||||||||||||||||||||||
| 302 | 1 | ▶ | if ($@) { | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 303 | 0 | die "ERROR defining accessors for '$class':" | |||||||||||||||||||||||||||
| 304 | . "\n\t$@\n" | ||||||||||||||||||||||||||||
| 305 | . "-----------------------------------------------------\n" | ||||||||||||||||||||||||||||
| 306 | . $code; | ||||||||||||||||||||||||||||
| 307 | } | ||||||||||||||||||||||||||||
| 308 | |||||||||||||||||||||||||||||
| 309 | ## Create private fields | ||||||||||||||||||||||||||||
| 310 | |||||||||||||||||||||||||||||
| 311 | #prt_data(" init_class: class=$class FIELD_LIST=", \%FIELD_LIST) if $global_debug>=4 ; | ||||||||||||||||||||||||||||
| 312 | |||||||||||||||||||||||||||||
| 313 | # Finished | ||||||||||||||||||||||||||||
| 314 | 1 | $CLASS_INIT{$class}=1; | |||||||||||||||||||||||||||
| 315 | } | ||||||||||||||||||||||||||||
| 316 | |||||||||||||||||||||||||||||
| 317 | 2 | ▶ | print "init_class() - done\n" if $global_debug>=3 ; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 318 | } | ||||||||||||||||||||||||||||
| 319 | |||||||||||||||||||||||||||||
| 320 | #----------------------------------------------------------------------------- | ||||||||||||||||||||||||||||
| 321 | |||||||||||||||||||||||||||||
| 322 | =item B<add_fields($fields_href, $args_href)> | ||||||||||||||||||||||||||||
| 323 | |||||||||||||||||||||||||||||
| 324 | Adds the contents of the HASH ref $fields_href to the args HASH ref ($args_href) under the key | ||||||||||||||||||||||||||||
| 325 | 'fields'. Used by derived objects to add their fields to the parent object's fields. | ||||||||||||||||||||||||||||
| 326 | |||||||||||||||||||||||||||||
| 327 | |||||||||||||||||||||||||||||
| 328 | =cut | ||||||||||||||||||||||||||||
| 329 | |||||||||||||||||||||||||||||
| 330 | sub add_fields | ||||||||||||||||||||||||||||
| 331 | 0 | ▶ | { | ||||||||||||||||||||||||||
|
Subroutine
add_fields: not called CC=2 SCAR=17.9
Pod
documented
| |||||||||||||||||||||||||||||
| 332 | 0 | my $this = shift ; | |||||||||||||||||||||||||||
| 333 | 0 | my ($fields_href, $args_href) = @_ ; | |||||||||||||||||||||||||||
| 334 | |||||||||||||||||||||||||||||
| 335 | # Add extra fields | ||||||||||||||||||||||||||||
| 336 | 0 | foreach (keys %$fields_href) | |||||||||||||||||||||||||||
| 337 | { | ||||||||||||||||||||||||||||
| 338 | 0 | $args_href->{'fields'}{$_} = $fields_href->{$_} ; | |||||||||||||||||||||||||||
| 339 | } | ||||||||||||||||||||||||||||
| 340 | |||||||||||||||||||||||||||||
| 341 | } | ||||||||||||||||||||||||||||
| 342 | |||||||||||||||||||||||||||||
| 343 | #----------------------------------------------------------------------------- | ||||||||||||||||||||||||||||
| 344 | |||||||||||||||||||||||||||||
| 345 | =item B<init_class_instance([%args])> | ||||||||||||||||||||||||||||
| 346 | |||||||||||||||||||||||||||||
| 347 | Initialises the object class variables. Creates a class instance so that these | ||||||||||||||||||||||||||||
| 348 | methods can also be called via the class (don't need a specific instance) | ||||||||||||||||||||||||||||
| 349 | |||||||||||||||||||||||||||||
| 350 | =cut | ||||||||||||||||||||||||||||
| 351 | |||||||||||||||||||||||||||||
| 352 | sub init_class_instance | ||||||||||||||||||||||||||||
| 353 | 0 | ▶ | { | ||||||||||||||||||||||||||
|
Subroutine
init_class_instance: not called CC=1 SCAR=6.9
Pod
documented
| |||||||||||||||||||||||||||||
| 354 | 0 | my $class = shift ; | |||||||||||||||||||||||||||
| 355 | 0 | my (%args) = @_ ; | |||||||||||||||||||||||||||
| 356 | |||||||||||||||||||||||||||||
| 357 | 0 | $class->init_class(%args) ; | |||||||||||||||||||||||||||
| 358 | |||||||||||||||||||||||||||||
| 359 | # Create a class instance object - allows these methods to be called via class | ||||||||||||||||||||||||||||
| 360 | 0 | $class->class_instance(%args) ; | |||||||||||||||||||||||||||
| 361 | |||||||||||||||||||||||||||||
| 362 | # Set any global values | ||||||||||||||||||||||||||||
| 363 | 0 | $class->set(%args) ; | |||||||||||||||||||||||||||
| 364 | } | ||||||||||||||||||||||||||||
| 365 | |||||||||||||||||||||||||||||
| 366 | #---------------------------------------------------------------------------- | ||||||||||||||||||||||||||||
| 367 | # Return global fields hash | ||||||||||||||||||||||||||||
| 368 | sub _field_list | ||||||||||||||||||||||||||||
| 369 | 0 | ▶ | { | ||||||||||||||||||||||||||
|
Subroutine
_field_list: not called CC=1 SCAR=6.9
| |||||||||||||||||||||||||||||
| 370 | 0 | my $class = shift ; | |||||||||||||||||||||||||||
| 371 | |||||||||||||||||||||||||||||
| 372 | 0 | return %FIELD_LIST ; | |||||||||||||||||||||||||||
| 373 | } | ||||||||||||||||||||||||||||
| 374 | |||||||||||||||||||||||||||||
| 375 | #============================================================================================ | ||||||||||||||||||||||||||||
| 376 | # CLASS METHODS | ||||||||||||||||||||||||||||
| 377 | #============================================================================================ | ||||||||||||||||||||||||||||
| 378 | |||||||||||||||||||||||||||||
| 379 | #---------------------------------------------------------------------------- | ||||||||||||||||||||||||||||
| 380 | |||||||||||||||||||||||||||||
| 381 | =item B<global_debug(level)> | ||||||||||||||||||||||||||||
| 382 | |||||||||||||||||||||||||||||
| 383 | Set global debug print options to I<level>. | ||||||||||||||||||||||||||||
| 384 | |||||||||||||||||||||||||||||
| 385 | 0 = No debug | ||||||||||||||||||||||||||||
| 386 | 1 = standard debug information | ||||||||||||||||||||||||||||
| 387 | 2 = verbose debug information | ||||||||||||||||||||||||||||
| 388 | |||||||||||||||||||||||||||||
| 389 | =cut | ||||||||||||||||||||||||||||
| 390 | |||||||||||||||||||||||||||||
| 391 | sub global_debug | ||||||||||||||||||||||||||||
| 392 | 0 | ▶ | { | ||||||||||||||||||||||||||
|
Subroutine
global_debug: not called CC=2 SCAR=17.9
Pod
documented
| |||||||||||||||||||||||||||||
| 393 | 0 | my $this = shift ; | |||||||||||||||||||||||||||
| 394 | 0 | my ($flag) = @_ ; | |||||||||||||||||||||||||||
| 395 | |||||||||||||||||||||||||||||
| 396 | #my $class = $this->class() ; | ||||||||||||||||||||||||||||
| 397 | ##my $class = ref($this) || $this ; | ||||||||||||||||||||||||||||
| 398 | |||||||||||||||||||||||||||||
| 399 | 0 | my $old = $global_debug ; | |||||||||||||||||||||||||||
| 400 | 0 | ▶ | $global_debug = $flag if defined($flag) ; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 401 | |||||||||||||||||||||||||||||
| 402 | 0 | return $old ; | |||||||||||||||||||||||||||
| 403 | } | ||||||||||||||||||||||||||||
| 404 | |||||||||||||||||||||||||||||
| 405 | |||||||||||||||||||||||||||||
| 406 | #---------------------------------------------------------------------------- | ||||||||||||||||||||||||||||
| 407 | |||||||||||||||||||||||||||||
| 408 | =item B<global_verbose(level)> | ||||||||||||||||||||||||||||
| 409 | |||||||||||||||||||||||||||||
| 410 | Set global verbose print level to I<level>. | ||||||||||||||||||||||||||||
| 411 | |||||||||||||||||||||||||||||
| 412 | 0 = None verbose | ||||||||||||||||||||||||||||
| 413 | 1 = verbose information | ||||||||||||||||||||||||||||
| 414 | 2 = print commands | ||||||||||||||||||||||||||||
| 415 | 3 = print command results | ||||||||||||||||||||||||||||
| 416 | |||||||||||||||||||||||||||||
| 417 | =cut | ||||||||||||||||||||||||||||
| 418 | |||||||||||||||||||||||||||||
| 419 | sub global_verbose | ||||||||||||||||||||||||||||
| 420 | 0 | ▶ | { | ||||||||||||||||||||||||||
|
Subroutine
global_verbose: not called CC=2 SCAR=17.9
Pod
documented
| |||||||||||||||||||||||||||||
| 421 | 0 | my $this = shift ; | |||||||||||||||||||||||||||
| 422 | 0 | my ($flag) = @_ ; | |||||||||||||||||||||||||||
| 423 | |||||||||||||||||||||||||||||
| 424 | #my $class = $this->class() ; | ||||||||||||||||||||||||||||
| 425 | ##my $class = ref($this) || $this ; | ||||||||||||||||||||||||||||
| 426 | |||||||||||||||||||||||||||||
| 427 | 0 | my $old = $global_verbose ; | |||||||||||||||||||||||||||
| 428 | 0 | ▶ | $global_verbose = $flag if defined($flag) ; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 429 | |||||||||||||||||||||||||||||
| 430 | 0 | return $old ; | |||||||||||||||||||||||||||
| 431 | } | ||||||||||||||||||||||||||||
| 432 | |||||||||||||||||||||||||||||
| 433 | #---------------------------------------------------------------------------- | ||||||||||||||||||||||||||||
| 434 | |||||||||||||||||||||||||||||
| 435 | =item B<strict_fields($flag)> | ||||||||||||||||||||||||||||
| 436 | |||||||||||||||||||||||||||||
| 437 | Enable/disable strict field checking | ||||||||||||||||||||||||||||
| 438 | |||||||||||||||||||||||||||||
| 439 | =cut | ||||||||||||||||||||||||||||
| 440 | |||||||||||||||||||||||||||||
| 441 | sub strict_fields | ||||||||||||||||||||||||||||
| 442 | 0 | ▶ | { | ||||||||||||||||||||||||||
|
Subroutine
strict_fields: not called CC=2 SCAR=17.9
Pod
documented
| |||||||||||||||||||||||||||||
| 443 | 0 | my $this = shift ; | |||||||||||||||||||||||||||
| 444 | 0 | my ($flag) = @_ ; | |||||||||||||||||||||||||||
| 445 | |||||||||||||||||||||||||||||
| 446 | #my $class = $this->class() ; | ||||||||||||||||||||||||||||
| 447 | ##my $class = ref($this) || $this ; | ||||||||||||||||||||||||||||
| 448 | |||||||||||||||||||||||||||||
| 449 | 0 | my $old = $strict_fields ; | |||||||||||||||||||||||||||
| 450 | 0 | ▶ | $strict_fields = $flag if defined($flag) ; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 451 | |||||||||||||||||||||||||||||
| 452 | 0 | return $old ; | |||||||||||||||||||||||||||
| 453 | } | ||||||||||||||||||||||||||||
| 454 | |||||||||||||||||||||||||||||
| 455 | #---------------------------------------------------------------------------- | ||||||||||||||||||||||||||||
| 456 | |||||||||||||||||||||||||||||
| 457 | =item B<class_instance([%args])> | ||||||||||||||||||||||||||||
| 458 | |||||||||||||||||||||||||||||
| 459 | Returns an object that can be used for class-based calls - object contains | ||||||||||||||||||||||||||||
| 460 | all the usual fields | ||||||||||||||||||||||||||||
| 461 | |||||||||||||||||||||||||||||
| 462 | =cut | ||||||||||||||||||||||||||||
| 463 | |||||||||||||||||||||||||||||
| 464 | sub class_instance | ||||||||||||||||||||||||||||
| 465 | 2 | ▶ | { | ||||||||||||||||||||||||||
|
Subroutine
class_instance: called CC=5 SCAR=16.6
Pod
documented
| |||||||||||||||||||||||||||||
| 466 | 2 | my $this = shift ; | |||||||||||||||||||||||||||
| 467 | 2 | my (@args) = @_ ; | |||||||||||||||||||||||||||
| 468 | |||||||||||||||||||||||||||||
| 469 | #my $class = $this->class() ; | ||||||||||||||||||||||||||||
| 470 | 2 | ▶ | my $class = ref($this) || $this ; | ||||||||||||||||||||||||||
|
Condition33%1/3
ref $this || $this
MC/DC0%0/2
ref $this || $this
ref $this
$this
Truth table33%1/3
A || B
A= ref $thisB= $this
| |||||||||||||||||||||||||||||
| 471 | |||||||||||||||||||||||||||||
| 472 | 2 | ▶ | if ($class->allowed_class_instance() && !$class->has_class_instance()) | ||||||||||||||||||||||||||
|
Branch: 1 branch
Condition66%2/3
$class->allowed_class_instance and not $class->has_class_instance
MC/DC50%1/2
$class->allowed_class_instance and not $class->has_class_instance
$class->allowed_class_instance
not $class->has_class_instance
Truth table66%2/3
A and not(B)
A= $class->allowed_class_instanceB= not $class->has_class_instance
| |||||||||||||||||||||||||||||
| 473 | { | ||||||||||||||||||||||||||||
| 474 | 1 | $CLASS_INSTANCE{$class} = 1 ; # ensure we don't get here again (breaks recursive loop) | |||||||||||||||||||||||||||
| 475 | |||||||||||||||||||||||||||||
| 476 | 1 | ▶ | print "-- Create class instance --\n" if $global_debug>=3 ; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 477 | |||||||||||||||||||||||||||||
| 478 | # Need to create one using the args | ||||||||||||||||||||||||||||
| 479 | 1 | $CLASS_INSTANCE{$class} = $class->new(@args) ; | |||||||||||||||||||||||||||
| 480 | } | ||||||||||||||||||||||||||||
| 481 | |||||||||||||||||||||||||||||
| 482 | |||||||||||||||||||||||||||||
| 483 | 2 | return $CLASS_INSTANCE{$class} ; | |||||||||||||||||||||||||||
| 484 | } | ||||||||||||||||||||||||||||
| 485 | |||||||||||||||||||||||||||||
| 486 | #---------------------------------------------------------------------------- | ||||||||||||||||||||||||||||
| 487 | |||||||||||||||||||||||||||||
| 488 | =item B<has_class_instance()> | ||||||||||||||||||||||||||||
| 489 | |||||||||||||||||||||||||||||
| 490 | Returns true if this class has a class instance object | ||||||||||||||||||||||||||||
| 491 | |||||||||||||||||||||||||||||
| 492 | =cut | ||||||||||||||||||||||||||||
| 493 | |||||||||||||||||||||||||||||
| 494 | sub has_class_instance | ||||||||||||||||||||||||||||
| 495 | 2 | ▶ | { | ||||||||||||||||||||||||||
|
Subroutine
has_class_instance: called CC=2 SCAR=7.6
Pod
documented
| |||||||||||||||||||||||||||||
| 496 | 2 | my $this = shift ; | |||||||||||||||||||||||||||
| 497 | #my $class = $this->class() ; | ||||||||||||||||||||||||||||
| 498 | 2 | ▶ | my $class = ref($this) || $this ; | ||||||||||||||||||||||||||
|
Condition33%1/3
ref $this || $this
MC/DC0%0/2
ref $this || $this
ref $this
$this
Truth table33%1/3
A || B
A= ref $thisB= $this
| |||||||||||||||||||||||||||||
| 499 | |||||||||||||||||||||||||||||
| 500 | #prt_data("has_class_instance($class) CLASS_INSTANCE=", \%CLASS_INSTANCE) if $global_debug>=5 ; | ||||||||||||||||||||||||||||
| 501 | |||||||||||||||||||||||||||||
| 502 | 2 | return exists($CLASS_INSTANCE{$class}) ; | |||||||||||||||||||||||||||
| 503 | } | ||||||||||||||||||||||||||||
| 504 | |||||||||||||||||||||||||||||
| 505 | #---------------------------------------------------------------------------- | ||||||||||||||||||||||||||||
| 506 | |||||||||||||||||||||||||||||
| 507 | =item B<allowed_class_instance()> | ||||||||||||||||||||||||||||
| 508 | |||||||||||||||||||||||||||||
| 509 | Returns true if this class can have a class instance object | ||||||||||||||||||||||||||||
| 510 | |||||||||||||||||||||||||||||
| 511 | =cut | ||||||||||||||||||||||||||||
| 512 | |||||||||||||||||||||||||||||
| 513 | sub allowed_class_instance | ||||||||||||||||||||||||||||
| 514 | 2 | ▶ | { | ||||||||||||||||||||||||||
|
Subroutine
allowed_class_instance: called CC=1 SCAR=0.0
Pod
documented
| |||||||||||||||||||||||||||||
| 515 | 2 | return 1 ; | |||||||||||||||||||||||||||
| 516 | } | ||||||||||||||||||||||||||||
| 517 | |||||||||||||||||||||||||||||
| 518 | #---------------------------------------------------------------------------- | ||||||||||||||||||||||||||||
| 519 | |||||||||||||||||||||||||||||
| 520 | =item B<field_list()> | ||||||||||||||||||||||||||||
| 521 | |||||||||||||||||||||||||||||
| 522 | Returns hash of object's field definitions. | ||||||||||||||||||||||||||||
| 523 | |||||||||||||||||||||||||||||
| 524 | =cut | ||||||||||||||||||||||||||||
| 525 | |||||||||||||||||||||||||||||
| 526 | sub field_list | ||||||||||||||||||||||||||||
| 527 | 0 | ▶ | { | ||||||||||||||||||||||||||
|
Subroutine
field_list: not called CC=4 SCAR=30.0
Pod
documented
| |||||||||||||||||||||||||||||
| 528 | 0 | my $this = shift ; | |||||||||||||||||||||||||||
| 529 | |||||||||||||||||||||||||||||
| 530 | #my $class = $this->class() ; | ||||||||||||||||||||||||||||
| 531 | 0 | ▶ | my $class = ref($this) || $this ; | ||||||||||||||||||||||||||
|
Condition0%0/3
ref $this || $this
MC/DC0%0/2
ref $this || $this
ref $this
$this
Truth table0%0/3
A || B
A= ref $thisB= $this
| |||||||||||||||||||||||||||||
| 532 | |||||||||||||||||||||||||||||
| 533 | 0 | my $href ; | |||||||||||||||||||||||||||
| 534 | 0 | ▶ | $href = $FIELD_LIST{$class} if exists($FIELD_LIST{$class}) ; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 535 | |||||||||||||||||||||||||||||
| 536 | 0 | ▶ | return $href ? %$href : () ; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 537 | } | ||||||||||||||||||||||||||||
| 538 | |||||||||||||||||||||||||||||
| 539 | |||||||||||||||||||||||||||||
| 540 | #============================================================================================ | ||||||||||||||||||||||||||||
| 541 | # OBJECT DATA METHODS | ||||||||||||||||||||||||||||
| 542 | #============================================================================================ | ||||||||||||||||||||||||||||
| 543 | |||||||||||||||||||||||||||||
| 544 | #---------------------------------------------------------------------------- | ||||||||||||||||||||||||||||
| 545 | |||||||||||||||||||||||||||||
| 546 | =item B<debug(level)> | ||||||||||||||||||||||||||||
| 547 | |||||||||||||||||||||||||||||
| 548 | Set debug print options to I<level>. | ||||||||||||||||||||||||||||
| 549 | |||||||||||||||||||||||||||||
| 550 | |||||||||||||||||||||||||||||
| 551 | =cut | ||||||||||||||||||||||||||||
| 552 | |||||||||||||||||||||||||||||
| 553 | sub debug | ||||||||||||||||||||||||||||
| 554 | 0 | ▶ | { | ||||||||||||||||||||||||||
|
Subroutine
debug: not called CC=4 SCAR=30.0
Pod
documented
| |||||||||||||||||||||||||||||
| 555 | 0 | my $this = shift ; | |||||||||||||||||||||||||||
| 556 | 0 | my ($level) = @_ ; | |||||||||||||||||||||||||||
| 557 | |||||||||||||||||||||||||||||
| 558 | #my $class = $this->class() ; | ||||||||||||||||||||||||||||
| 559 | 0 | ▶ | my $class = ref($this) || $this ; | ||||||||||||||||||||||||||
|
Condition0%0/3
ref $this || $this
MC/DC0%0/2
ref $this || $this
ref $this
$this
Truth table0%0/3
A || B
A= ref $thisB= $this
| |||||||||||||||||||||||||||||
| 560 | #print "In debug() for $class\n" ; | ||||||||||||||||||||||||||||
| 561 | |||||||||||||||||||||||||||||
| 562 | 0 | ▶ | $DEBUG{$class} ||= 0 ; | ||||||||||||||||||||||||||
|
Condition0%0/2
$DEBUG{$class} ||= 0
MC/DC0%0/1
$DEBUG{$class} ||= 0
$DEBUG{$class}
Truth table0%0/2
A
A= $DEBUG{$class}
| |||||||||||||||||||||||||||||
| 563 | 0 | my $old = $DEBUG{$class} ; | |||||||||||||||||||||||||||
| 564 | 0 | ▶ | $DEBUG{$class} = $level if defined($level) ; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 565 | |||||||||||||||||||||||||||||
| 566 | 0 | return $old ; | |||||||||||||||||||||||||||
| 567 | } | ||||||||||||||||||||||||||||
| 568 | |||||||||||||||||||||||||||||
| 569 | #---------------------------------------------------------------------------- | ||||||||||||||||||||||||||||
| 570 | |||||||||||||||||||||||||||||
| 571 | =item B<undef_debug()> | ||||||||||||||||||||||||||||
| 572 | |||||||||||||||||||||||||||||
| 573 | Set debug print options flag to undefined. | ||||||||||||||||||||||||||||
| 574 | |||||||||||||||||||||||||||||
| 575 | |||||||||||||||||||||||||||||
| 576 | =cut | ||||||||||||||||||||||||||||
| 577 | |||||||||||||||||||||||||||||
| 578 | sub undef_debug | ||||||||||||||||||||||||||||
| 579 | 2 | ▶ | { | ||||||||||||||||||||||||||
|
Subroutine
undef_debug: called CC=3 SCAR=11.4
Pod
documented
| |||||||||||||||||||||||||||||
| 580 | 2 | my $this = shift ; | |||||||||||||||||||||||||||
| 581 | 2 | my ($level) = @_ ; | |||||||||||||||||||||||||||
| 582 | |||||||||||||||||||||||||||||
| 583 | #my $class = $this->class() ; | ||||||||||||||||||||||||||||
| 584 | 2 | ▶ | my $class = ref($this) || $this ; | ||||||||||||||||||||||||||
|
Condition33%1/3
ref $this || $this
MC/DC0%0/2
ref $this || $this
ref $this
$this
Truth table33%1/3
A || B
A= ref $thisB= $this
| |||||||||||||||||||||||||||||
| 585 | #print "In undef_debug() for $class\n" ; | ||||||||||||||||||||||||||||
| 586 | |||||||||||||||||||||||||||||
| 587 | 2 | ▶ | $DEBUG{$class} ||= 0 ; | ||||||||||||||||||||||||||
|
Condition50%1/2
$DEBUG{$class} ||= 0
MC/DC0%0/1
$DEBUG{$class} ||= 0
$DEBUG{$class}
Truth table50%1/2
A
A= $DEBUG{$class}
| |||||||||||||||||||||||||||||
| 588 | 2 | my $old = $DEBUG{$class} ; | |||||||||||||||||||||||||||
| 589 | 2 | $DEBUG{$class} = undef ; | |||||||||||||||||||||||||||
| 590 | |||||||||||||||||||||||||||||
| 591 | 2 | return $old ; | |||||||||||||||||||||||||||
| 592 | } | ||||||||||||||||||||||||||||
| 593 | |||||||||||||||||||||||||||||
| 594 | |||||||||||||||||||||||||||||
| 595 | #---------------------------------------------------------------------------- | ||||||||||||||||||||||||||||
| 596 | |||||||||||||||||||||||||||||
| 597 | =item B<verbose(level)> | ||||||||||||||||||||||||||||
| 598 | |||||||||||||||||||||||||||||
| 599 | Set verbose print options to I<level>. | ||||||||||||||||||||||||||||
| 600 | |||||||||||||||||||||||||||||
| 601 | |||||||||||||||||||||||||||||
| 602 | =cut | ||||||||||||||||||||||||||||
| 603 | |||||||||||||||||||||||||||||
| 604 | sub verbose | ||||||||||||||||||||||||||||
| 605 | 0 | ▶ | { | ||||||||||||||||||||||||||
|
Subroutine
verbose: not called CC=4 SCAR=30.0
Pod
documented
| |||||||||||||||||||||||||||||
| 606 | 0 | my $this = shift ; | |||||||||||||||||||||||||||
| 607 | 0 | my ($level) = @_ ; | |||||||||||||||||||||||||||
| 608 | |||||||||||||||||||||||||||||
| 609 | #my $class = $this->class() ; | ||||||||||||||||||||||||||||
| 610 | 0 | ▶ | my $class = ref($this) || $this ; | ||||||||||||||||||||||||||
|
Condition0%0/3
ref $this || $this
MC/DC0%0/2
ref $this || $this
ref $this
$this
Truth table0%0/3
A || B
A= ref $thisB= $this
| |||||||||||||||||||||||||||||
| 611 | #print "In verbose() for $class\n" ; | ||||||||||||||||||||||||||||
| 612 | |||||||||||||||||||||||||||||
| 613 | 0 | ▶ | $VERBOSE{$class} ||= 0 ; | ||||||||||||||||||||||||||
|
Condition0%0/2
$VERBOSE{$class} ||= 0
MC/DC0%0/1
$VERBOSE{$class} ||= 0
$VERBOSE{$class}
Truth table0%0/2
A
A= $VERBOSE{$class}
| |||||||||||||||||||||||||||||
| 614 | 0 | my $old = $VERBOSE{$class} ; | |||||||||||||||||||||||||||
| 615 | 0 | ▶ | $VERBOSE{$class} = $level if defined($level) ; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 616 | |||||||||||||||||||||||||||||
| 617 | 0 | return $old ; | |||||||||||||||||||||||||||
| 618 | } | ||||||||||||||||||||||||||||
| 619 | |||||||||||||||||||||||||||||
| 620 | #---------------------------------------------------------------------------- | ||||||||||||||||||||||||||||
| 621 | |||||||||||||||||||||||||||||
| 622 | =item B<undef_verbose()> | ||||||||||||||||||||||||||||
| 623 | |||||||||||||||||||||||||||||
| 624 | Set verbose print options flag to undefined. | ||||||||||||||||||||||||||||
| 625 | |||||||||||||||||||||||||||||
| 626 | |||||||||||||||||||||||||||||
| 627 | =cut | ||||||||||||||||||||||||||||
| 628 | |||||||||||||||||||||||||||||
| 629 | sub undef_verbose | ||||||||||||||||||||||||||||
| 630 | 2 | ▶ | { | ||||||||||||||||||||||||||
|
Subroutine
undef_verbose: called CC=3 SCAR=11.4
Pod
documented
| |||||||||||||||||||||||||||||
| 631 | 2 | my $this = shift ; | |||||||||||||||||||||||||||
| 632 | 2 | my ($level) = @_ ; | |||||||||||||||||||||||||||
| 633 | |||||||||||||||||||||||||||||
| 634 | #my $class = $this->class() ; | ||||||||||||||||||||||||||||
| 635 | 2 | ▶ | my $class = ref($this) || $this ; | ||||||||||||||||||||||||||
|
Condition33%1/3
ref $this || $this
MC/DC0%0/2
ref $this || $this
ref $this
$this
Truth table33%1/3
A || B
A= ref $thisB= $this
| |||||||||||||||||||||||||||||
| 636 | #print "In undef_verbose() for $class\n" ; | ||||||||||||||||||||||||||||
| 637 | |||||||||||||||||||||||||||||
| 638 | 2 | ▶ | $DEBUG{$class} ||= 0 ; | ||||||||||||||||||||||||||
|
Condition50%1/2
$DEBUG{$class} ||= 0
MC/DC0%0/1
$DEBUG{$class} ||= 0
$DEBUG{$class}
Truth table50%1/2
A
A= $DEBUG{$class}
| |||||||||||||||||||||||||||||
| 639 | 2 | my $old = $DEBUG{$class} ; | |||||||||||||||||||||||||||
| 640 | 2 | $DEBUG{$class} = undef ; | |||||||||||||||||||||||||||
| 641 | |||||||||||||||||||||||||||||
| 642 | 2 | return $old ; | |||||||||||||||||||||||||||
| 643 | } | ||||||||||||||||||||||||||||
| 644 | |||||||||||||||||||||||||||||
| 645 | #---------------------------------------------------------------------------- | ||||||||||||||||||||||||||||
| 646 | |||||||||||||||||||||||||||||
| 647 | =item B<field_access($field, [$val])> | ||||||||||||||||||||||||||||
| 648 | |||||||||||||||||||||||||||||
| 649 | Get/set a field value. Used by derived objects to get/set the underlying object field | ||||||||||||||||||||||||||||
| 650 | variable when they have overridden that field's access method. | ||||||||||||||||||||||||||||
| 651 | |||||||||||||||||||||||||||||
| 652 | =cut | ||||||||||||||||||||||||||||
| 653 | |||||||||||||||||||||||||||||
| 654 | sub field_access | ||||||||||||||||||||||||||||
| 655 | 0 | ▶ | { | ||||||||||||||||||||||||||
|
Subroutine
field_access: not called CC=5 SCAR=34.0
Pod
documented
| |||||||||||||||||||||||||||||
| 656 | 0 | my $this = shift ; | |||||||||||||||||||||||||||
| 657 | 0 | my ($field, $value) = @_ ; | |||||||||||||||||||||||||||
| 658 | |||||||||||||||||||||||||||||
| 659 | 0 | ▶ | my $class = ref($this) || $this ; | ||||||||||||||||||||||||||
|
Condition0%0/3
ref $this || $this
MC/DC0%0/2
ref $this || $this
ref $this
$this
Truth table0%0/3
A || B
A= ref $thisB= $this
| |||||||||||||||||||||||||||||
| 660 | 0 | my %field_list = (); | |||||||||||||||||||||||||||
| 661 | 0 | ▶ | %field_list = %{ $FIELD_LIST{$class} } if exists($FIELD_LIST{$class}) ; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 662 | 0 | ▶ | $this->throw_fatal("Attempting to access an invalid field \"$field\" for this object class \"$class\" ") unless (exists($field_list{$field})) ; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 663 | |||||||||||||||||||||||||||||
| 664 | 0 | ▶ | $this->{$field} = $value if defined($value) ; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 665 | 0 | return $this->{$field} ; | |||||||||||||||||||||||||||
| 666 | } | ||||||||||||||||||||||||||||
| 667 | |||||||||||||||||||||||||||||
| 668 | |||||||||||||||||||||||||||||
| 669 | |||||||||||||||||||||||||||||
| 670 | |||||||||||||||||||||||||||||
| 671 | |||||||||||||||||||||||||||||
| 672 | #---------------------------------------------------------------------------- | ||||||||||||||||||||||||||||
| 673 | |||||||||||||||||||||||||||||
| 674 | =item B<set(%args)> | ||||||||||||||||||||||||||||
| 675 | |||||||||||||||||||||||||||||
| 676 | Set one or more settable parameter. | ||||||||||||||||||||||||||||
| 677 | |||||||||||||||||||||||||||||
| 678 | The %args are specified as a hash, for example | ||||||||||||||||||||||||||||
| 679 | |||||||||||||||||||||||||||||
| 680 | set('mmap_handler' => $mmap_handler) | ||||||||||||||||||||||||||||
| 681 | |||||||||||||||||||||||||||||
| 682 | Sets field values. Field values are expressed as part of the HASH (i.e. normal | ||||||||||||||||||||||||||||
| 683 | field => value pairs). | ||||||||||||||||||||||||||||
| 684 | |||||||||||||||||||||||||||||
| 685 | =cut | ||||||||||||||||||||||||||||
| 686 | |||||||||||||||||||||||||||||
| 687 | sub set | ||||||||||||||||||||||||||||
| 688 | 6 | ▶ | { | ||||||||||||||||||||||||||
|
Subroutine
set: called CC=11 SCAR=27.2
Pod
documented
| |||||||||||||||||||||||||||||
| 689 | 6 | my $this = shift ; | |||||||||||||||||||||||||||
| 690 | 6 | my (%args) = @_ ; | |||||||||||||||||||||||||||
| 691 | |||||||||||||||||||||||||||||
| 692 | # prt_data("set() ARGS=", \%args, "\n") if $global_debug>=3 ; | ||||||||||||||||||||||||||||
| 693 | |||||||||||||||||||||||||||||
| 694 | 6 | $this = $this->check_instance() ; | |||||||||||||||||||||||||||
| 695 | |||||||||||||||||||||||||||||
| 696 | # Args | ||||||||||||||||||||||||||||
| 697 | ## my %field_list = $this->field_list() ; | ||||||||||||||||||||||||||||
| 698 | 6 | ▶ | my $class = ref($this) || $this ; | ||||||||||||||||||||||||||
|
Condition33%1/3
ref $this || $this
MC/DC0%0/2
ref $this || $this
ref $this
$this
Truth table33%1/3
A || B
A= ref $thisB= $this
| |||||||||||||||||||||||||||||
| 699 | 6 | my %field_list = (); | |||||||||||||||||||||||||||
| 700 | 6 | ▶ | %field_list = %{ $FIELD_LIST{$class} } if exists($FIELD_LIST{$class}) ; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 701 | |||||||||||||||||||||||||||||
| 702 | 6 | foreach my $field (keys %field_list) | |||||||||||||||||||||||||||
| 703 | { | ||||||||||||||||||||||||||||
| 704 | 36 | ▶ | if (exists($args{$field})) | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 705 | { | ||||||||||||||||||||||||||||
| 706 | 20 | ▶ | print " + set $field = $args{$field}\n" if $global_debug>=3 ; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 707 | |||||||||||||||||||||||||||||
| 708 | # Need to call actual method (rather than ___set) so that it can be overridden | ||||||||||||||||||||||||||||
| 709 | 20 | ▶ | if (!defined($args{$field})) | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 710 | { | ||||||||||||||||||||||||||||
| 711 | # Set to undef | ||||||||||||||||||||||||||||
| 712 | 7 | my $undef_method = "undef_$field" ; | |||||||||||||||||||||||||||
| 713 | 7 | $this->$undef_method() ; | |||||||||||||||||||||||||||
| 714 | } | ||||||||||||||||||||||||||||
| 715 | else | ||||||||||||||||||||||||||||
| 716 | { | ||||||||||||||||||||||||||||
| 717 | 13 | $this->$field($args{$field}) ; | |||||||||||||||||||||||||||
| 718 | } | ||||||||||||||||||||||||||||
| 719 | } | ||||||||||||||||||||||||||||
| 720 | } | ||||||||||||||||||||||||||||
| 721 | |||||||||||||||||||||||||||||
| 722 | ## See if strict checks are enabled | ||||||||||||||||||||||||||||
| 723 | 6 | ▶ | if ($strict_fields) | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 724 | { | ||||||||||||||||||||||||||||
| 725 | # Check to ensure that only the valid fields are being set | ||||||||||||||||||||||||||||
| 726 | 0 | foreach my $field (keys %args) | |||||||||||||||||||||||||||
| 727 | { | ||||||||||||||||||||||||||||
| 728 | 0 | ▶ | if (!exists($field_list{$field})) | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 729 | { | ||||||||||||||||||||||||||||
| 730 | 0 | print "WARNING::Attempt to set invalid field \"$field\" \n" ; | |||||||||||||||||||||||||||
| 731 | 0 | $this->dump_callstack() ; | |||||||||||||||||||||||||||
| 732 | } | ||||||||||||||||||||||||||||
| 733 | } | ||||||||||||||||||||||||||||
| 734 | } | ||||||||||||||||||||||||||||
| 735 | |||||||||||||||||||||||||||||
| 736 | 6 | ▶ | print "set() - done\n" if $global_debug>=3 ; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 737 | |||||||||||||||||||||||||||||
| 738 | } | ||||||||||||||||||||||||||||
| 739 | |||||||||||||||||||||||||||||
| 740 | #---------------------------------------------------------------------------- | ||||||||||||||||||||||||||||
| 741 | |||||||||||||||||||||||||||||
| 742 | =item B<vars([@names])> | ||||||||||||||||||||||||||||
| 743 | |||||||||||||||||||||||||||||
| 744 | Returns hash of object's fields (i.e. field name => field value pairs). | ||||||||||||||||||||||||||||
| 745 | |||||||||||||||||||||||||||||
| 746 | If @names array is specified, then only returns the HASH containing the named fields. | ||||||||||||||||||||||||||||
| 747 | |||||||||||||||||||||||||||||
| 748 | =cut | ||||||||||||||||||||||||||||
| 749 | |||||||||||||||||||||||||||||
| 750 | sub vars | ||||||||||||||||||||||||||||
| 751 | 0 | ▶ | { | ||||||||||||||||||||||||||
|
Subroutine
vars: not called CC=6 SCAR=37.4
Pod
documented
| |||||||||||||||||||||||||||||
| 752 | 0 | my $this = shift ; | |||||||||||||||||||||||||||
| 753 | 0 | my (@names) = @_ ; | |||||||||||||||||||||||||||
| 754 | |||||||||||||||||||||||||||||
| 755 | ## my %field_list = $this->field_list() ; | ||||||||||||||||||||||||||||
| 756 | 0 | ▶ | my $class = ref($this) || $this ; | ||||||||||||||||||||||||||
|
Condition0%0/3
ref $this || $this
MC/DC0%0/2
ref $this || $this
ref $this
$this
Truth table0%0/3
A || B
A= ref $thisB= $this
| |||||||||||||||||||||||||||||
| 757 | 0 | my %field_list = (); | |||||||||||||||||||||||||||
| 758 | 0 | ▶ | %field_list = %{ $FIELD_LIST{$class} } if exists($FIELD_LIST{$class}) ; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 759 | |||||||||||||||||||||||||||||
| 760 | 0 | my %fields ; | |||||||||||||||||||||||||||
| 761 | |||||||||||||||||||||||||||||
| 762 | #prt_data("vars() names=", \@names) ; | ||||||||||||||||||||||||||||
| 763 | |||||||||||||||||||||||||||||
| 764 | # If no names specified then get all of them | ||||||||||||||||||||||||||||
| 765 | 0 | ▶ | unless (@names) | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 766 | { | ||||||||||||||||||||||||||||
| 767 | 0 | @names = keys %field_list ; | |||||||||||||||||||||||||||
| 768 | } | ||||||||||||||||||||||||||||
| 769 | 0 | my %names = map {$_ => 1} @names ; | |||||||||||||||||||||||||||
| 770 | #prt_data(" + names=", \%names) ; | ||||||||||||||||||||||||||||
| 771 | |||||||||||||||||||||||||||||
| 772 | # Get the value of each field | ||||||||||||||||||||||||||||
| 773 | 0 | foreach my $field (keys %field_list) | |||||||||||||||||||||||||||
| 774 | { | ||||||||||||||||||||||||||||
| 775 | # Store field if we've asked for it | ||||||||||||||||||||||||||||
| 776 | 0 | ▶ | $fields{$field} = $this->$field() if exists($names{$field}) ; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 777 | #print " + + $field : " ; | ||||||||||||||||||||||||||||
| 778 | #if (exists($fields{$field})) | ||||||||||||||||||||||||||||
| 779 | #{ | ||||||||||||||||||||||||||||
| 780 | # print "ok ($fields{$field})\n" ; | ||||||||||||||||||||||||||||
| 781 | #} | ||||||||||||||||||||||||||||
| 782 | #else | ||||||||||||||||||||||||||||
| 783 | #{ | ||||||||||||||||||||||||||||
| 784 | # print "not wanted\n" ; | ||||||||||||||||||||||||||||
| 785 | #} | ||||||||||||||||||||||||||||
| 786 | } | ||||||||||||||||||||||||||||
| 787 | |||||||||||||||||||||||||||||
| 788 | 0 | return %fields ; | |||||||||||||||||||||||||||
| 789 | } | ||||||||||||||||||||||||||||
| 790 | |||||||||||||||||||||||||||||
| 791 | |||||||||||||||||||||||||||||
| 792 | |||||||||||||||||||||||||||||
| 793 | |||||||||||||||||||||||||||||
| 794 | #---------------------------------------------------------------------------- | ||||||||||||||||||||||||||||
| 795 | |||||||||||||||||||||||||||||
| 796 | =item B<DESTROY()> | ||||||||||||||||||||||||||||
| 797 | |||||||||||||||||||||||||||||
| 798 | Destroy object | ||||||||||||||||||||||||||||
| 799 | |||||||||||||||||||||||||||||
| 800 | =cut | ||||||||||||||||||||||||||||
| 801 | |||||||||||||||||||||||||||||
| 802 | sub DESTROY | ||||||||||||||||||||||||||||
| 803 | 1 | ▶ | { | ||||||||||||||||||||||||||
|
Subroutine
DESTROY: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||
| 804 | 1 | my $this = shift ; | |||||||||||||||||||||||||||
| 805 | |||||||||||||||||||||||||||||
| 806 | } | ||||||||||||||||||||||||||||
| 807 | |||||||||||||||||||||||||||||
| 808 | |||||||||||||||||||||||||||||
| 809 | #============================================================================================ | ||||||||||||||||||||||||||||
| 810 | # OBJECT METHODS | ||||||||||||||||||||||||||||
| 811 | #============================================================================================ | ||||||||||||||||||||||||||||
| 812 | |||||||||||||||||||||||||||||
| 813 | #---------------------------------------------------------------------------- | ||||||||||||||||||||||||||||
| 814 | |||||||||||||||||||||||||||||
| 815 | =item B<check_instance()> | ||||||||||||||||||||||||||||
| 816 | |||||||||||||||||||||||||||||
| 817 | If this is not an instance (i.e. a class call), then if there is a class_instance | ||||||||||||||||||||||||||||
| 818 | defined use it, otherwise error. | ||||||||||||||||||||||||||||
| 819 | |||||||||||||||||||||||||||||
| 820 | =cut | ||||||||||||||||||||||||||||
| 821 | |||||||||||||||||||||||||||||
| 822 | sub check_instance | ||||||||||||||||||||||||||||
| 823 | 8 | ▶ | { | ||||||||||||||||||||||||||
|
Subroutine
check_instance: called CC=4 SCAR=21.7
Pod
documented
| |||||||||||||||||||||||||||||
| 824 | 8 | my $this = shift ; | |||||||||||||||||||||||||||
| 825 | 8 | my (%args) = @_ ; | |||||||||||||||||||||||||||
| 826 | |||||||||||||||||||||||||||||
| 827 | #my $class = $this->class() ; | ||||||||||||||||||||||||||||
| 828 | |||||||||||||||||||||||||||||
| 829 | 8 | ▶ | if (!ref($this)) | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 830 | { | ||||||||||||||||||||||||||||
| 831 | 0 | ▶ | my $class = ref($this) || $this ; | ||||||||||||||||||||||||||
|
Condition0%0/3
ref $this || $this
MC/DC0%0/2
ref $this || $this
ref $this
$this
Truth table0%0/3
A || B
A= ref $thisB= $this
| |||||||||||||||||||||||||||||
| 832 | 0 | ▶ | if ($class->has_class_instance()) | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 833 | { | ||||||||||||||||||||||||||||
| 834 | 0 | $this = $class->class_instance() ; | |||||||||||||||||||||||||||
| 835 | } | ||||||||||||||||||||||||||||
| 836 | else | ||||||||||||||||||||||||||||
| 837 | { | ||||||||||||||||||||||||||||
| 838 | 0 | croak "$this is not a usable object" ; | |||||||||||||||||||||||||||
| 839 | } | ||||||||||||||||||||||||||||
| 840 | } | ||||||||||||||||||||||||||||
| 841 | |||||||||||||||||||||||||||||
| 842 | 8 | return $this ; | |||||||||||||||||||||||||||
| 843 | } | ||||||||||||||||||||||||||||
| 844 | |||||||||||||||||||||||||||||
| 845 | |||||||||||||||||||||||||||||
| 846 | #---------------------------------------------------------------------------- | ||||||||||||||||||||||||||||
| 847 | |||||||||||||||||||||||||||||
| 848 | =item B<copy_attributes($target)> | ||||||||||||||||||||||||||||
| 849 | |||||||||||||||||||||||||||||
| 850 | Transfers all the supported attributes from $this object to $target object. | ||||||||||||||||||||||||||||
| 851 | |||||||||||||||||||||||||||||
| 852 | =cut | ||||||||||||||||||||||||||||
| 853 | |||||||||||||||||||||||||||||
| 854 | sub copy_attributes | ||||||||||||||||||||||||||||
| 855 | 0 | ▶ | { | ||||||||||||||||||||||||||
|
Subroutine
copy_attributes: not called CC=3 SCAR=24.8
Pod
documented
| |||||||||||||||||||||||||||||
| 856 | 0 | my $this = shift ; | |||||||||||||||||||||||||||
| 857 | 0 | my ($target) = @_ ; | |||||||||||||||||||||||||||
| 858 | |||||||||||||||||||||||||||||
| 859 | 0 | $this = $this->check_instance() ; | |||||||||||||||||||||||||||
| 860 | 0 | $target = $target->check_instance() ; | |||||||||||||||||||||||||||
| 861 | |||||||||||||||||||||||||||||
| 862 | # Get list of fields in the target | ||||||||||||||||||||||||||||
| 863 | 0 | my %target_field_list = $target->field_list() ; | |||||||||||||||||||||||||||
| 864 | |||||||||||||||||||||||||||||
| 865 | # Copy values from this object | ||||||||||||||||||||||||||||
| 866 | 0 | my %field_list = $this->field_list() ; | |||||||||||||||||||||||||||
| 867 | 0 | foreach my $field (keys %target_field_list) | |||||||||||||||||||||||||||
| 868 | { | ||||||||||||||||||||||||||||
| 869 | # see if can copy | ||||||||||||||||||||||||||||
| 870 | 0 | ▶ | if (exists($field_list{$field})) | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 871 | { | ||||||||||||||||||||||||||||
| 872 | 0 | $target->set($field => $this->$field()) ; | |||||||||||||||||||||||||||
| 873 | } | ||||||||||||||||||||||||||||
| 874 | } | ||||||||||||||||||||||||||||
| 875 | |||||||||||||||||||||||||||||
| 876 | } | ||||||||||||||||||||||||||||
| 877 | |||||||||||||||||||||||||||||
| 878 | #---------------------------------------------------------------------------- | ||||||||||||||||||||||||||||
| 879 | |||||||||||||||||||||||||||||
| 880 | =item B<class()> | ||||||||||||||||||||||||||||
| 881 | |||||||||||||||||||||||||||||
| 882 | Returns name of object class. | ||||||||||||||||||||||||||||
| 883 | |||||||||||||||||||||||||||||
| 884 | =cut | ||||||||||||||||||||||||||||
| 885 | |||||||||||||||||||||||||||||
| 886 | sub class | ||||||||||||||||||||||||||||
| 887 | 0 | ▶ | { | ||||||||||||||||||||||||||
|
Subroutine
class: not called CC=2 SCAR=17.9
Pod
documented
| |||||||||||||||||||||||||||||
| 888 | 0 | my $this = shift ; | |||||||||||||||||||||||||||
| 889 | |||||||||||||||||||||||||||||
| 890 | 0 | ▶ | my $class = ref($this) || $this ; | ||||||||||||||||||||||||||
|
Condition0%0/3
ref $this || $this
MC/DC0%0/2
ref $this || $this
ref $this
$this
Truth table0%0/3
A || B
A= ref $thisB= $this
| |||||||||||||||||||||||||||||
| 891 | |||||||||||||||||||||||||||||
| 892 | 0 | return $class ; | |||||||||||||||||||||||||||
| 893 | } | ||||||||||||||||||||||||||||
| 894 | |||||||||||||||||||||||||||||
| 895 | #---------------------------------------------------------------------------- | ||||||||||||||||||||||||||||
| 896 | |||||||||||||||||||||||||||||
| 897 | =item B<clone()> | ||||||||||||||||||||||||||||
| 898 | |||||||||||||||||||||||||||||
| 899 | Create a copy of this object and return the copy. | ||||||||||||||||||||||||||||
| 900 | |||||||||||||||||||||||||||||
| 901 | =cut | ||||||||||||||||||||||||||||
| 902 | |||||||||||||||||||||||||||||
| 903 | sub clone | ||||||||||||||||||||||||||||
| 904 | 0 | ▶ | { | ||||||||||||||||||||||||||
|
Subroutine
clone: not called CC=1 SCAR=6.9
Pod
documented
| |||||||||||||||||||||||||||||
| 905 | 0 | my $this = shift ; | |||||||||||||||||||||||||||
| 906 | |||||||||||||||||||||||||||||
| 907 | 0 | my $clone ; | |||||||||||||||||||||||||||
| 908 | |||||||||||||||||||||||||||||
| 909 | # TODO: WRITE IT! | ||||||||||||||||||||||||||||
| 910 | |||||||||||||||||||||||||||||
| 911 | 0 | return $clone ; | |||||||||||||||||||||||||||
| 912 | } | ||||||||||||||||||||||||||||
| 913 | |||||||||||||||||||||||||||||
| 914 | |||||||||||||||||||||||||||||
| 915 | |||||||||||||||||||||||||||||
| 916 | # ============================================================================================ | ||||||||||||||||||||||||||||
| 917 | # UTILITY METHODS | ||||||||||||||||||||||||||||
| 918 | # ============================================================================================ | ||||||||||||||||||||||||||||
| 919 | |||||||||||||||||||||||||||||
| 920 | |||||||||||||||||||||||||||||
| 921 | |||||||||||||||||||||||||||||
| 922 | #---------------------------------------------------------------------------- | ||||||||||||||||||||||||||||
| 923 | |||||||||||||||||||||||||||||
| 924 | =item B<quote_str($str)> | ||||||||||||||||||||||||||||
| 925 | |||||||||||||||||||||||||||||
| 926 | Returns a quoted version of the string. | ||||||||||||||||||||||||||||
| 927 | |||||||||||||||||||||||||||||
| 928 | =cut | ||||||||||||||||||||||||||||
| 929 | |||||||||||||||||||||||||||||
| 930 | sub quote_str | ||||||||||||||||||||||||||||
| 931 | 0 | ▶ | { | ||||||||||||||||||||||||||
|
Subroutine
quote_str: not called CC=2 SCAR=17.9
Pod
documented
| |||||||||||||||||||||||||||||
| 932 | 0 | my $this = shift ; | |||||||||||||||||||||||||||
| 933 | 0 | my ($str) = @_ ; | |||||||||||||||||||||||||||
| 934 | |||||||||||||||||||||||||||||
| 935 | ##my $class = $this->class() ; | ||||||||||||||||||||||||||||
| 936 | |||||||||||||||||||||||||||||
| 937 | # skip on Windows machines | ||||||||||||||||||||||||||||
| 938 | 0 | ▶ | unless ($^O eq 'MSWin32') | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 939 | { | ||||||||||||||||||||||||||||
| 940 | # first escape any existing quotes | ||||||||||||||||||||||||||||
| 941 | 0 | $str =~ s%\\'%'%g ; | |||||||||||||||||||||||||||
| 942 | 0 | $str =~ s%'%'\\''%g ; | |||||||||||||||||||||||||||
| 943 | |||||||||||||||||||||||||||||
| 944 | 0 | $str = "'".$str."'" ; | |||||||||||||||||||||||||||
| 945 | } | ||||||||||||||||||||||||||||
| 946 | |||||||||||||||||||||||||||||
| 947 | |||||||||||||||||||||||||||||
| 948 | 0 | return $str ; | |||||||||||||||||||||||||||
| 949 | } | ||||||||||||||||||||||||||||
| 950 | |||||||||||||||||||||||||||||
| 951 | #---------------------------------------------------------------------------- | ||||||||||||||||||||||||||||
| 952 | |||||||||||||||||||||||||||||
| 953 | =item B<expand_vars($string, \%vars)> | ||||||||||||||||||||||||||||
| 954 | |||||||||||||||||||||||||||||
| 955 | Work through string expanding any variables, replacing them with the value stored in the %vars hash. | ||||||||||||||||||||||||||||
| 956 | If variable is not stored in %vars, then that variable is left. | ||||||||||||||||||||||||||||
| 957 | |||||||||||||||||||||||||||||
| 958 | Returns expanded string. | ||||||||||||||||||||||||||||
| 959 | |||||||||||||||||||||||||||||
| 960 | =cut | ||||||||||||||||||||||||||||
| 961 | |||||||||||||||||||||||||||||
| 962 | sub expand_vars | ||||||||||||||||||||||||||||
| 963 | 0 | ▶ | { | ||||||||||||||||||||||||||
|
Subroutine
expand_vars: not called CC=2 SCAR=13.0
Pod
documented
| |||||||||||||||||||||||||||||
| 964 | 0 | my $this = shift ; | |||||||||||||||||||||||||||
| 965 | 0 | my ($string, $vars_href) = @_ ; | |||||||||||||||||||||||||||
| 966 | |||||||||||||||||||||||||||||
| 967 | |||||||||||||||||||||||||||||
| 968 | # Do replacement | ||||||||||||||||||||||||||||
| 969 | 0 | $string =~ s{ | |||||||||||||||||||||||||||
| 970 | \$ # find a literal dollar sign | ||||||||||||||||||||||||||||
| 971 | \{{0,1} # optional brace | ||||||||||||||||||||||||||||
| 972 | (\w+) # find a "word" and store it in $1 | ||||||||||||||||||||||||||||
| 973 | \}{0,1} # optional brace | ||||||||||||||||||||||||||||
| 974 | }{ | ||||||||||||||||||||||||||||
| 975 | 7 | ▶ | no strict 'refs'; # for $$1 below | ||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||
| 976 | 0 | ▶ | if (defined $vars_href->{$1}) { | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 977 | 0 | $vars_href->{$1}; # expand variable | |||||||||||||||||||||||||||
| 978 | } else { | ||||||||||||||||||||||||||||
| 979 | 0 | "\${$1}"; # leave it | |||||||||||||||||||||||||||
| 980 | } | ||||||||||||||||||||||||||||
| 981 | }egx; | ||||||||||||||||||||||||||||
| 982 | |||||||||||||||||||||||||||||
| 983 | 0 | return $string ; | |||||||||||||||||||||||||||
| 984 | } | ||||||||||||||||||||||||||||
| 985 | |||||||||||||||||||||||||||||
| 986 | |||||||||||||||||||||||||||||
| 987 | |||||||||||||||||||||||||||||
| 988 | ##--------------------------------------------------------------------- | ||||||||||||||||||||||||||||
| 989 | # | ||||||||||||||||||||||||||||
| 990 | #=item B<prt_data(@args)> | ||||||||||||||||||||||||||||
| 991 | # | ||||||||||||||||||||||||||||
| 992 | #Use App::Framework::Lite::Object::DumpObj to print out variable information. Automatically enables | ||||||||||||||||||||||||||||
| 993 | #object print out | ||||||||||||||||||||||||||||
| 994 | # | ||||||||||||||||||||||||||||
| 995 | #=cut | ||||||||||||||||||||||||||||
| 996 | # | ||||||||||||||||||||||||||||
| 997 | #sub prt_data | ||||||||||||||||||||||||||||
| 998 | #{ | ||||||||||||||||||||||||||||
| 999 | # my $this = shift ; | ||||||||||||||||||||||||||||
| 1000 | # my (@args) = @_ ; | ||||||||||||||||||||||||||||
| 1001 | # | ||||||||||||||||||||||||||||
| 1002 | # App::Framework::Lite::Object::DumpObj::print_objects_flag(1) ; | ||||||||||||||||||||||||||||
| 1003 | # App::Framework::Lite::Object::DumpObj::prt_data(@args) ; | ||||||||||||||||||||||||||||
| 1004 | #} | ||||||||||||||||||||||||||||
| 1005 | # | ||||||||||||||||||||||||||||
| 1006 | ##---------------------------------------------------------------------------- | ||||||||||||||||||||||||||||
| 1007 | ## | ||||||||||||||||||||||||||||
| 1008 | ##=item B<_dbg_prt($items_aref [, $min_debug])> | ||||||||||||||||||||||||||||
| 1009 | ## | ||||||||||||||||||||||||||||
| 1010 | ##Print out the items in the $items_aref ARRAY ref iff the calling object's debug level is >0. | ||||||||||||||||||||||||||||
| 1011 | ##If $min_debug is specified, will only print out items if the calling object's debug level is >= $min_debug. | ||||||||||||||||||||||||||||
| 1012 | ## | ||||||||||||||||||||||||||||
| 1013 | ##=cut | ||||||||||||||||||||||||||||
| 1014 | ## | ||||||||||||||||||||||||||||
| 1015 | #sub _dbg_prt | ||||||||||||||||||||||||||||
| 1016 | #{ | ||||||||||||||||||||||||||||
| 1017 | # my $obj = shift ; | ||||||||||||||||||||||||||||
| 1018 | # my ($items_aref, $min_debug) = @_ ; | ||||||||||||||||||||||||||||
| 1019 | # | ||||||||||||||||||||||||||||
| 1020 | # $min_debug ||= 1 ; | ||||||||||||||||||||||||||||
| 1021 | # | ||||||||||||||||||||||||||||
| 1022 | # ## check debug level setting | ||||||||||||||||||||||||||||
| 1023 | # if ($obj->debug >= $min_debug) | ||||||||||||||||||||||||||||
| 1024 | # { | ||||||||||||||||||||||||||||
| 1025 | # my $pkg = ref($obj) ; | ||||||||||||||||||||||||||||
| 1026 | # $pkg =~ s/App::Framework/ApFw/ ; | ||||||||||||||||||||||||||||
| 1027 | # | ||||||||||||||||||||||||||||
| 1028 | # my $prefix = App::Framework::Lite::Object::DumpObj::prefix("$pkg :: ") ; | ||||||||||||||||||||||||||||
| 1029 | # $obj->prt_data(@$items_aref) ; | ||||||||||||||||||||||||||||
| 1030 | # App::Framework::Lite::Object::DumpObj::prefix($prefix) ; | ||||||||||||||||||||||||||||
| 1031 | # } | ||||||||||||||||||||||||||||
| 1032 | #} | ||||||||||||||||||||||||||||
| 1033 | |||||||||||||||||||||||||||||
| 1034 | |||||||||||||||||||||||||||||
| 1035 | |||||||||||||||||||||||||||||
| 1036 | #--------------------------------------------------------------------- | ||||||||||||||||||||||||||||
| 1037 | |||||||||||||||||||||||||||||
| 1038 | =item B<dump_callstack()> | ||||||||||||||||||||||||||||
| 1039 | |||||||||||||||||||||||||||||
| 1040 | Print out the call stack. Useful for debug output at a crash site. | ||||||||||||||||||||||||||||
| 1041 | =cut | ||||||||||||||||||||||||||||
| 1042 | |||||||||||||||||||||||||||||
| 1043 | sub dump_callstack | ||||||||||||||||||||||||||||
| 1044 | 0 | ▶ | { | ||||||||||||||||||||||||||
|
Subroutine
dump_callstack: not called CC=3 SCAR=24.8
Pod
documented
| |||||||||||||||||||||||||||||
| 1045 | 0 | my $this = shift ; | |||||||||||||||||||||||||||
| 1046 | 0 | my ($package, $filename, $line, $subr, $has_args, $wantarray) ; | |||||||||||||||||||||||||||
| 1047 | 0 | my $i=0 ; | |||||||||||||||||||||||||||
| 1048 | 0 | print "\n-----------------------------------------\n"; | |||||||||||||||||||||||||||
| 1049 | do | ||||||||||||||||||||||||||||
| 1050 | 0 | ▶ | { | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 1051 | 0 | ($package, $filename, $line, $subr, $has_args, $wantarray) = caller($i++) ; | |||||||||||||||||||||||||||
| 1052 | 0 | ▶ | if ($subr) | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 1053 | { | ||||||||||||||||||||||||||||
| 1054 | 0 | print "$filename :: $subr :: $line\n" ; | |||||||||||||||||||||||||||
| 1055 | } | ||||||||||||||||||||||||||||
| 1056 | } | ||||||||||||||||||||||||||||
| 1057 | while($subr) ; | ||||||||||||||||||||||||||||
| 1058 | 0 | print "-----------------------------------------\n\n"; | |||||||||||||||||||||||||||
| 1059 | } | ||||||||||||||||||||||||||||
| 1060 | |||||||||||||||||||||||||||||
| 1061 | |||||||||||||||||||||||||||||
| 1062 | |||||||||||||||||||||||||||||
| 1063 | # ============================================================================================ | ||||||||||||||||||||||||||||
| 1064 | # PRIVATE METHODS | ||||||||||||||||||||||||||||
| 1065 | # ============================================================================================ | ||||||||||||||||||||||||||||
| 1066 | |||||||||||||||||||||||||||||
| 1067 | #---------------------------------------------------------------------------- | ||||||||||||||||||||||||||||
| 1068 | # Set field value | ||||||||||||||||||||||||||||
| 1069 | sub ___set | ||||||||||||||||||||||||||||
| 1070 | 0 | ▶ | { | ||||||||||||||||||||||||||
|
Subroutine
___set: not called CC=7 SCAR=40.3
| |||||||||||||||||||||||||||||
| 1071 | 0 | my $this = shift ; | |||||||||||||||||||||||||||
| 1072 | 0 | my ($field, $new_value) = @_ ; | |||||||||||||||||||||||||||
| 1073 | |||||||||||||||||||||||||||||
| 1074 | ## NEW | ||||||||||||||||||||||||||||
| 1075 | 0 | ▶ | if ($global_debug>=10) | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 1076 | { | ||||||||||||||||||||||||||||
| 1077 | 0 | print "Unexpected ___set($field, $new_value)\n" ; | |||||||||||||||||||||||||||
| 1078 | 0 | $this->dump_callstack() ; | |||||||||||||||||||||||||||
| 1079 | } | ||||||||||||||||||||||||||||
| 1080 | ## NEW | ||||||||||||||||||||||||||||
| 1081 | |||||||||||||||||||||||||||||
| 1082 | |||||||||||||||||||||||||||||
| 1083 | #my $class = $this->class() ; | ||||||||||||||||||||||||||||
| 1084 | 0 | my $value ; | |||||||||||||||||||||||||||
| 1085 | |||||||||||||||||||||||||||||
| 1086 | # Check that field name is valid | ||||||||||||||||||||||||||||
| 1087 | ## my %field_list = $this->field_list() ; | ||||||||||||||||||||||||||||
| 1088 | 0 | ▶ | my $class = ref($this) || $this ; | ||||||||||||||||||||||||||
|
Condition0%0/3
ref $this || $this
MC/DC0%0/2
ref $this || $this
ref $this
$this
Truth table0%0/3
A || B
A= ref $thisB= $this
| |||||||||||||||||||||||||||||
| 1089 | 0 | my %field_list = (); | |||||||||||||||||||||||||||
| 1090 | 0 | ▶ | %field_list = %{ $FIELD_LIST{$class} } if exists($FIELD_LIST{$class}) ; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 1091 | |||||||||||||||||||||||||||||
| 1092 | 0 | ▶ | if (!exists($field_list{$field})) | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 1093 | { | ||||||||||||||||||||||||||||
| 1094 | ## my $class = ref($this) || $this ; | ||||||||||||||||||||||||||||
| 1095 | |||||||||||||||||||||||||||||
| 1096 | # prt_data("$class : ___set($field) invalid field. Valid fields=", \%field_list) if $global_debug>=5 ; | ||||||||||||||||||||||||||||
| 1097 | 0 | ▶ | $this->dump_callstack() if $global_debug>=10 ; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 1098 | |||||||||||||||||||||||||||||
| 1099 | # TODO: Do something more useful! | ||||||||||||||||||||||||||||
| 1100 | 0 | croak "$class: Attempting to write invalid field $field" ; | |||||||||||||||||||||||||||
| 1101 | } | ||||||||||||||||||||||||||||
| 1102 | else | ||||||||||||||||||||||||||||
| 1103 | { | ||||||||||||||||||||||||||||
| 1104 | # get existing value | ||||||||||||||||||||||||||||
| 1105 | 0 | $value = $this->{$field} ; | |||||||||||||||||||||||||||
| 1106 | |||||||||||||||||||||||||||||
| 1107 | # write | ||||||||||||||||||||||||||||
| 1108 | 0 | $this->{$field} = $new_value ; | |||||||||||||||||||||||||||
| 1109 | } | ||||||||||||||||||||||||||||
| 1110 | 0 | ▶ | print " + ___set($field) <= $new_value (was $value)\n" if $global_debug>=5 ; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 1111 | |||||||||||||||||||||||||||||
| 1112 | # Return previous value | ||||||||||||||||||||||||||||
| 1113 | 0 | return $value ; | |||||||||||||||||||||||||||
| 1114 | } | ||||||||||||||||||||||||||||
| 1115 | |||||||||||||||||||||||||||||
| 1116 | #---------------------------------------------------------------------------- | ||||||||||||||||||||||||||||
| 1117 | # get field value | ||||||||||||||||||||||||||||
| 1118 | sub ___get | ||||||||||||||||||||||||||||
| 1119 | 0 | ▶ | { | ||||||||||||||||||||||||||
|
Subroutine
___get: not called CC=7 SCAR=40.3
| |||||||||||||||||||||||||||||
| 1120 | 0 | my $this = shift ; | |||||||||||||||||||||||||||
| 1121 | 0 | my ($field) = @_ ; | |||||||||||||||||||||||||||
| 1122 | |||||||||||||||||||||||||||||
| 1123 | 0 | my $value ; | |||||||||||||||||||||||||||
| 1124 | |||||||||||||||||||||||||||||
| 1125 | #my $class = $this->class() ; | ||||||||||||||||||||||||||||
| 1126 | |||||||||||||||||||||||||||||
| 1127 | ## NEW | ||||||||||||||||||||||||||||
| 1128 | 0 | ▶ | if ($global_debug>=10) | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 1129 | { | ||||||||||||||||||||||||||||
| 1130 | 0 | print "Unexpected ___get($field)\n" ; | |||||||||||||||||||||||||||
| 1131 | 0 | $this->dump_callstack() ; | |||||||||||||||||||||||||||
| 1132 | } | ||||||||||||||||||||||||||||
| 1133 | ## NEW | ||||||||||||||||||||||||||||
| 1134 | |||||||||||||||||||||||||||||
| 1135 | |||||||||||||||||||||||||||||
| 1136 | # Check that field name is valid | ||||||||||||||||||||||||||||
| 1137 | ## my %field_list = $this->field_list() ; | ||||||||||||||||||||||||||||
| 1138 | 0 | ▶ | my $class = ref($this) || $this ; | ||||||||||||||||||||||||||
|
Condition0%0/3
ref $this || $this
MC/DC0%0/2
ref $this || $this
ref $this
$this
Truth table0%0/3
A || B
A= ref $thisB= $this
| |||||||||||||||||||||||||||||
| 1139 | 0 | my %field_list = (); | |||||||||||||||||||||||||||
| 1140 | 0 | ▶ | %field_list = %{ $FIELD_LIST{$class} } if exists($FIELD_LIST{$class}) ; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 1141 | |||||||||||||||||||||||||||||
| 1142 | 0 | ▶ | if (!exists($field_list{$field})) | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 1143 | { | ||||||||||||||||||||||||||||
| 1144 | ## my $class = ref($this) || $this ; | ||||||||||||||||||||||||||||
| 1145 | |||||||||||||||||||||||||||||
| 1146 | # prt_data("$class : ___get($field) invalid field. Valid fields=", \%field_list) if $global_debug>=5 ; | ||||||||||||||||||||||||||||
| 1147 | #prt_data("$class : ___get($field) invalid field. Valid fields=", \%field_list) ; | ||||||||||||||||||||||||||||
| 1148 | 0 | ▶ | $this->dump_callstack() if $global_debug>=10 ; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 1149 | #$this->dump_callstack() ; | ||||||||||||||||||||||||||||
| 1150 | |||||||||||||||||||||||||||||
| 1151 | # TODO: Do something more useful! | ||||||||||||||||||||||||||||
| 1152 | 0 | croak "$class: Attempting to access invalid method $field (or read using invalid data accessor)" ; | |||||||||||||||||||||||||||
| 1153 | } | ||||||||||||||||||||||||||||
| 1154 | else | ||||||||||||||||||||||||||||
| 1155 | { | ||||||||||||||||||||||||||||
| 1156 | # get existing value | ||||||||||||||||||||||||||||
| 1157 | 0 | $value = $this->{$field} ; | |||||||||||||||||||||||||||
| 1158 | } | ||||||||||||||||||||||||||||
| 1159 | |||||||||||||||||||||||||||||
| 1160 | 0 | ▶ | print " + ___get($field) = $value\n" if $global_debug>=5 ; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 1161 | |||||||||||||||||||||||||||||
| 1162 | # Return previous value | ||||||||||||||||||||||||||||
| 1163 | 0 | return $value ; | |||||||||||||||||||||||||||
| 1164 | } | ||||||||||||||||||||||||||||
| 1165 | |||||||||||||||||||||||||||||
| 1166 | |||||||||||||||||||||||||||||
| 1167 | # ============================================================================================ | ||||||||||||||||||||||||||||
| 1168 | |||||||||||||||||||||||||||||
| 1169 | # Autoload handle only field value set/undefine | ||||||||||||||||||||||||||||
| 1170 | # Set method = <name> | ||||||||||||||||||||||||||||
| 1171 | # Undefine method = undef_<name> | ||||||||||||||||||||||||||||
| 1172 | # | ||||||||||||||||||||||||||||
| 1173 | sub AUTOLOAD | ||||||||||||||||||||||||||||
| 1174 | 0 | ▶ | { | ||||||||||||||||||||||||||
|
Subroutine
AUTOLOAD: not called CC=8 SCAR=42.8
| |||||||||||||||||||||||||||||
| 1175 | 0 | ▶ | print "AUTOLOAD ($AUTOLOAD)\n" if $global_debug>=5 ; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 1176 | |||||||||||||||||||||||||||||
| 1177 | ## NEW | ||||||||||||||||||||||||||||
| 1178 | 0 | ▶ | if ($global_debug>=10) | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 1179 | { | ||||||||||||||||||||||||||||
| 1180 | 0 | my $caller = (caller())[0] ; | |||||||||||||||||||||||||||
| 1181 | 0 | print "Unexpected AUTOLOAD ($AUTOLOAD) from $caller\n" ; | |||||||||||||||||||||||||||
| 1182 | } | ||||||||||||||||||||||||||||
| 1183 | ## NEW | ||||||||||||||||||||||||||||
| 1184 | |||||||||||||||||||||||||||||
| 1185 | 0 | my $this = shift; | |||||||||||||||||||||||||||
| 1186 | # prt_data("AUTOLOAD ($AUTOLOAD) this=", $this) if $global_debug>=5 ; | ||||||||||||||||||||||||||||
| 1187 | |||||||||||||||||||||||||||||
| 1188 | #print "$this=",ref($this),"\n"; | ||||||||||||||||||||||||||||
| 1189 | 0 | ▶ | if (!ref($this)||ref($this)eq'ARRAY') | ||||||||||||||||||||||||||
|
Branch: 1 branch
Condition0%0/3
not ref $this or ref $this eq "ARRAY"
MC/DC0%0/2
not ref $this or ref $this eq "ARRAY"
not ref $this
ref $this eq "ARRAY"
Truth table0%0/3
not(A) or B
A= not ref $thisB= ref $this eq "ARRAY"
| |||||||||||||||||||||||||||||
| 1190 | { | ||||||||||||||||||||||||||||
| 1191 | 0 | croak "AUTOLOAD ($AUTOLOAD) (@_): $this is not a valid object" ; | |||||||||||||||||||||||||||
| 1192 | } | ||||||||||||||||||||||||||||
| 1193 | |||||||||||||||||||||||||||||
| 1194 | 0 | $this = $this->check_instance() ; | |||||||||||||||||||||||||||
| 1195 | # prt_data(" + this=", $this) if $global_debug>=5 ; | ||||||||||||||||||||||||||||
| 1196 | |||||||||||||||||||||||||||||
| 1197 | 0 | my $name = $AUTOLOAD; | |||||||||||||||||||||||||||
| 1198 | 0 | $name =~ s/.*://; # strip fully-qualified portion | |||||||||||||||||||||||||||
| 1199 | 0 | my $class = $AUTOLOAD; | |||||||||||||||||||||||||||
| 1200 | 0 | $class =~ s/::[^:]+$//; # get class | |||||||||||||||||||||||||||
| 1201 | |||||||||||||||||||||||||||||
| 1202 | 0 | my $type = ref($this) ; | |||||||||||||||||||||||||||
| 1203 | |||||||||||||||||||||||||||||
| 1204 | # if (!$type) | ||||||||||||||||||||||||||||
| 1205 | # { | ||||||||||||||||||||||||||||
| 1206 | # # see if there is a class instance object defined | ||||||||||||||||||||||||||||
| 1207 | # if ($class->has_class_instance()) | ||||||||||||||||||||||||||||
| 1208 | # { | ||||||||||||||||||||||||||||
| 1209 | # $this = $class->class_instance() ; | ||||||||||||||||||||||||||||
| 1210 | # $type = ref($this) ; | ||||||||||||||||||||||||||||
| 1211 | # } | ||||||||||||||||||||||||||||
| 1212 | # else | ||||||||||||||||||||||||||||
| 1213 | # { | ||||||||||||||||||||||||||||
| 1214 | # croak "$this is not an object"; | ||||||||||||||||||||||||||||
| 1215 | # } | ||||||||||||||||||||||||||||
| 1216 | # } | ||||||||||||||||||||||||||||
| 1217 | |||||||||||||||||||||||||||||
| 1218 | # possibly going to set a new value | ||||||||||||||||||||||||||||
| 1219 | 0 | my $set=0; | |||||||||||||||||||||||||||
| 1220 | 0 | my $new_value = shift; | |||||||||||||||||||||||||||
| 1221 | 0 | ▶ | $set = 1 if defined($new_value) ; | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 1222 | |||||||||||||||||||||||||||||
| 1223 | # 1st see if this is of the form undef_<name> | ||||||||||||||||||||||||||||
| 1224 | 0 | ▶ | if ($name =~ m/^undef_(\w+)$/) | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 1225 | { | ||||||||||||||||||||||||||||
| 1226 | 0 | $set = 1 ; | |||||||||||||||||||||||||||
| 1227 | 0 | $name = $1 ; | |||||||||||||||||||||||||||
| 1228 | 0 | $new_value = undef ; | |||||||||||||||||||||||||||
| 1229 | } | ||||||||||||||||||||||||||||
| 1230 | |||||||||||||||||||||||||||||
| 1231 | 0 | my $value = $this->___get($name); | |||||||||||||||||||||||||||
| 1232 | |||||||||||||||||||||||||||||
| 1233 | 0 | ▶ | if ($set) | ||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||
| 1234 | { | ||||||||||||||||||||||||||||
| 1235 | 0 | $this->___set($name, $new_value) ; | |||||||||||||||||||||||||||
| 1236 | } | ||||||||||||||||||||||||||||
| 1237 | |||||||||||||||||||||||||||||
| 1238 | # Return previous value | ||||||||||||||||||||||||||||
| 1239 | 0 | return $value ; | |||||||||||||||||||||||||||
| 1240 | } | ||||||||||||||||||||||||||||
| 1241 | |||||||||||||||||||||||||||||
| 1242 | |||||||||||||||||||||||||||||
| 1243 | |||||||||||||||||||||||||||||
| 1244 | # ============================================================================================ | ||||||||||||||||||||||||||||
| 1245 | # END OF PACKAGE | ||||||||||||||||||||||||||||
| 1246 | |||||||||||||||||||||||||||||
| 1247 | =back | ||||||||||||||||||||||||||||
| 1248 | |||||||||||||||||||||||||||||
| 1249 | =cut | ||||||||||||||||||||||||||||
| 1250 | |||||||||||||||||||||||||||||
| 1251 | 7 | 1; | |||||||||||||||||||||||||||
| 1252 | |||||||||||||||||||||||||||||
| 1253 | __END__ | ||||||||||||||||||||||||||||