| 1 | ### Data::DRef - Delimited-key access to complex data structures | ||||||||||||||||||||||||||||||||
| 2 | |||||||||||||||||||||||||||||||||
| 3 | ### Copyright 1996, 1997, 1998, 1999 Evolution Online Systems, Inc. | ||||||||||||||||||||||||||||||||
| 4 | # You may use this software for free under the terms of the Artistic License. | ||||||||||||||||||||||||||||||||
| 5 | |||||||||||||||||||||||||||||||||
| 6 | ### Change History | ||||||||||||||||||||||||||||||||
| 7 | # 1999-02-06 Added to CPAN module list. Repackaged for distribution. | ||||||||||||||||||||||||||||||||
| 8 | # 1999-01-31 Collapsed Data::Collection into Data::DRef. | ||||||||||||||||||||||||||||||||
| 9 | # 1999-01-31 Removed Data::Collection's dependancy on Data::Sorting. | ||||||||||||||||||||||||||||||||
| 10 | # 1999-01-22 Revision of documentation, and improved Exporter tagging. | ||||||||||||||||||||||||||||||||
| 11 | # 1998-12-01 Added get_value_for_optional_dref; minor doc revisions. | ||||||||||||||||||||||||||||||||
| 12 | # 1998-10-15 Added explicit undef return value from get_value_for_key. | ||||||||||||||||||||||||||||||||
| 13 | # 1998-10-14 Added doc caveat about possible use of UNIVERSAL methods. | ||||||||||||||||||||||||||||||||
| 14 | # 1998-10-07 Reworked, conventionalized documentation and Exporter behaviour. | ||||||||||||||||||||||||||||||||
| 15 | # 1998-10-06 Refactored value_for_keys algorithm; clarified dref syntax. | ||||||||||||||||||||||||||||||||
| 16 | # 1998-07-16 Preliminary support for DRef pragmas: ignore (!reverse). -Simon | ||||||||||||||||||||||||||||||||
| 17 | # 1998-05-21 Added undef behavior in matching_keys and matching_values. | ||||||||||||||||||||||||||||||||
| 18 | # 1998-05-07 Replaced map with foreach in a few places. | ||||||||||||||||||||||||||||||||
| 19 | # 1998-04-17 Updated to use new Data::Sorting interface. | ||||||||||||||||||||||||||||||||
| 20 | # 1998-04-10 Added hash_by_array_key. | ||||||||||||||||||||||||||||||||
| 21 | # 1998-04-09 Fixed single-item problem with scalarkeysof algorithm. -Simon | ||||||||||||||||||||||||||||||||
| 22 | # 1998-03-12 Patched dref manipulation functions to escape separator. | ||||||||||||||||||||||||||||||||
| 23 | # 1998-02-24 Changed valuesof to return value of non-ref arguments. -Piglet | ||||||||||||||||||||||||||||||||
| 24 | # 1998-01-30 Added array_by_hash_key($) and intersperse($@) -Simon | ||||||||||||||||||||||||||||||||
| 25 | # 1997-12-08 Removed package Data::Types, replaced with UNIVERSAL isa. | ||||||||||||||||||||||||||||||||
| 26 | # 1997-12-07 Exported uniqueindexby. -Piglet | ||||||||||||||||||||||||||||||||
| 27 | # 1997-11-24 Finished orderedindexby. | ||||||||||||||||||||||||||||||||
| 28 | # 1997-11-19 Renamed removekey function to shiftdref at Jeremy's suggestion. | ||||||||||||||||||||||||||||||||
| 29 | # 1997-11-14 Added resolveparens behaviour to standard syntax. | ||||||||||||||||||||||||||||||||
| 30 | # 1997-11-14 Added getDRef, setDRef functions as can() wrappers for get, set | ||||||||||||||||||||||||||||||||
| 31 | # 1997-11-13 Added orderedindexby, but it still needs a bit of work. | ||||||||||||||||||||||||||||||||
| 32 | # 1997-10-29 Add'l modifications; replaced recursion with iteration in get() | ||||||||||||||||||||||||||||||||
| 33 | # 1997-10-25 Revisions; separator changed from colon to period. | ||||||||||||||||||||||||||||||||
| 34 | # 1997-10-03 Refactored get and set operations | ||||||||||||||||||||||||||||||||
| 35 | # 1997-09-05 Package split from the original dataops.pm into Data::*. | ||||||||||||||||||||||||||||||||
| 36 | # 1997-04-18 Cleaned up documentation a smidge. | ||||||||||||||||||||||||||||||||
| 37 | # 1997-04-08 Added getbysubkeys, now called matching_values | ||||||||||||||||||||||||||||||||
| 38 | # 1997-01-29 Altered set to create hashes even for numerics | ||||||||||||||||||||||||||||||||
| 39 | # 1997-01-28 Possible fix to recurring "keysof operates on containers" error. | ||||||||||||||||||||||||||||||||
| 40 | # 1997-01-26 Catch bad argument types for sortby, indexby. | ||||||||||||||||||||||||||||||||
| 41 | # 1997-01-21 Failure for keysof, valuesof now returns () rather than undef. | ||||||||||||||||||||||||||||||||
| 42 | # 1997-01-21 Added scalarsof. | ||||||||||||||||||||||||||||||||
| 43 | # 1997-01-11 Cloned and cleaned for IWAE; removed asdf code to dictionary.pm. | ||||||||||||||||||||||||||||||||
| 44 | # 1996-11-18 Moved v2 code into production, additional cleanup. -Simon | ||||||||||||||||||||||||||||||||
| 45 | # 1996-11-13 Version 2.00, major overhaul. | ||||||||||||||||||||||||||||||||
| 46 | # 1996-10-29 Fixed set to handle '0' items. -Piglet | ||||||||||||||||||||||||||||||||
| 47 | # 1996-09-09 Various changes, esp. fixing get to handle '0' items. -Simon | ||||||||||||||||||||||||||||||||
| 48 | # 1996-07-24 Wrote copy, getString, added 'append' to set. | ||||||||||||||||||||||||||||||||
| 49 | # 1996-07-18 Wrote setData, fixed headers. -Piglet | ||||||||||||||||||||||||||||||||
| 50 | # 1996-07-18 Additional Exporter fudging. | ||||||||||||||||||||||||||||||||
| 51 | # 1996-07-17 Globalized theData. -Simon | ||||||||||||||||||||||||||||||||
| 52 | # 1996-07-13 Simplified getData into get; wrote set. -Piglet | ||||||||||||||||||||||||||||||||
| 53 | # 1996-06-25 Various tweaks. | ||||||||||||||||||||||||||||||||
| 54 | # 1996-06-24 First version of dataops.pm created. -Simon | ||||||||||||||||||||||||||||||||
| 55 | |||||||||||||||||||||||||||||||||
| 56 | package Data::DRef; | ||||||||||||||||||||||||||||||||
| 57 | |||||||||||||||||||||||||||||||||
| 58 | 2 | require 5; | |||||||||||||||||||||||||||||||
| 59 | 2 | ▶ | use strict; | ||||||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||||||
| 60 | 2 | ▶ | use Carp; | ||||||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||||||
| 61 | 2 | ▶ | use Exporter; | ||||||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||||||
| 62 | |||||||||||||||||||||||||||||||||
| 63 | 2 | ▶ | use String::Escape qw( printable unprintable ); | ||||||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||||||
| 64 | |||||||||||||||||||||||||||||||||
| 65 | 2 | ▶ | use vars qw( $VERSION @ISA %EXPORT_TAGS ); | ||||||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||||||
| 66 | 2 | $VERSION = 1999.02_06; | |||||||||||||||||||||||||||||||
| 67 | |||||||||||||||||||||||||||||||||
| 68 | 2 | push @ISA, qw( Exporter ); | |||||||||||||||||||||||||||||||
| 69 | 2 | %EXPORT_TAGS = ( | |||||||||||||||||||||||||||||||
| 70 | key_access => [ qw( | ||||||||||||||||||||||||||||||||
| 71 | get_keys get_values get_value_for_key set_value_for_key | ||||||||||||||||||||||||||||||||
| 72 | get_or_create_value_for_key get_reference_for_key | ||||||||||||||||||||||||||||||||
| 73 | get_value_for_keys set_value_for_keys | ||||||||||||||||||||||||||||||||
| 74 | ) ], | ||||||||||||||||||||||||||||||||
| 75 | dref_syntax => [ qw( | ||||||||||||||||||||||||||||||||
| 76 | $Separator $DRefPrefix dref_from_keys keys_from_dref | ||||||||||||||||||||||||||||||||
| 77 | join_drefs unshift_dref_key shift_dref_key resolve_pragmas | ||||||||||||||||||||||||||||||||
| 78 | ) ], | ||||||||||||||||||||||||||||||||
| 79 | dref_access => [ qw( | ||||||||||||||||||||||||||||||||
| 80 | get_key_drefs get_value_for_dref set_value_for_dref | ||||||||||||||||||||||||||||||||
| 81 | ) ], | ||||||||||||||||||||||||||||||||
| 82 | root_dref => [ qw( | ||||||||||||||||||||||||||||||||
| 83 | $Root get_value_for_root_dref set_value_for_root_dref | ||||||||||||||||||||||||||||||||
| 84 | ) ], | ||||||||||||||||||||||||||||||||
| 85 | 'select' => [ qw( | ||||||||||||||||||||||||||||||||
| 86 | matching_keys matching_values | ||||||||||||||||||||||||||||||||
| 87 | ) ], | ||||||||||||||||||||||||||||||||
| 88 | 'index' => [ qw( | ||||||||||||||||||||||||||||||||
| 89 | index_by_drefs unique_index_by_drefs ordered_index_by_drefs | ||||||||||||||||||||||||||||||||
| 90 | ) ], | ||||||||||||||||||||||||||||||||
| 91 | 'leaf' => [ qw( | ||||||||||||||||||||||||||||||||
| 92 | leaf_drefs leaf_values leaf_drefs_and_values | ||||||||||||||||||||||||||||||||
| 93 | ) ], | ||||||||||||||||||||||||||||||||
| 94 | compat => [ qw( | ||||||||||||||||||||||||||||||||
| 95 | getData setData getDRef setDRef joindref shiftdref $Root get set | ||||||||||||||||||||||||||||||||
| 96 | $Separator splitdref keysof valuesof scalarkeysof scalarkeysandvalues | ||||||||||||||||||||||||||||||||
| 97 | matching_values matching_keys indexby uniqueindexby orderedindexby | ||||||||||||||||||||||||||||||||
| 98 | ) ], | ||||||||||||||||||||||||||||||||
| 99 | ); | ||||||||||||||||||||||||||||||||
| 100 | 2 | Exporter::export_ok_tags( keys %EXPORT_TAGS ); | |||||||||||||||||||||||||||||||
| 101 | |||||||||||||||||||||||||||||||||
| 102 | ### Value-For-Key Interface | ||||||||||||||||||||||||||||||||
| 103 | |||||||||||||||||||||||||||||||||
| 104 | # @keys = get_keys($target) | ||||||||||||||||||||||||||||||||
| 105 | 3 | ▶ | sub get_keys { | ||||||||||||||||||||||||||||||
|
Subroutine
get_keys: called CC=4 SCAR=19.7
Pod
documented
| |||||||||||||||||||||||||||||||||
| 106 | 3 | my $target = shift; | |||||||||||||||||||||||||||||||
| 107 | |||||||||||||||||||||||||||||||||
| 108 | 3 | ▶ | if ( UNIVERSAL::can($target, 'm_get_keys') ) { | ||||||||||||||||||||||||||||||
|
Branch: 3 branches
| |||||||||||||||||||||||||||||||||
| 109 | 0 | return $target->m_get_keys(@_); | |||||||||||||||||||||||||||||||
| 110 | } elsif ( UNIVERSAL::isa($target, 'HASH') ) { | ||||||||||||||||||||||||||||||||
| 111 | 3 | return keys %$target; | |||||||||||||||||||||||||||||||
| 112 | } elsif ( UNIVERSAL::isa($target, 'ARRAY') ) { | ||||||||||||||||||||||||||||||||
| 113 | 0 | return ( 0 .. $#$target ); | |||||||||||||||||||||||||||||||
| 114 | } else { | ||||||||||||||||||||||||||||||||
| 115 | 0 | return (); | |||||||||||||||||||||||||||||||
| 116 | } | ||||||||||||||||||||||||||||||||
| 117 | } | ||||||||||||||||||||||||||||||||
| 118 | |||||||||||||||||||||||||||||||||
| 119 | # @values = get_values($target) | ||||||||||||||||||||||||||||||||
| 120 | # Returns a list of scalar values in a referenced hash or list | ||||||||||||||||||||||||||||||||
| 121 | 0 | ▶ | sub get_values { | ||||||||||||||||||||||||||||||
|
Subroutine
get_values: not called CC=5 SCAR=34.0
Pod
documented
| |||||||||||||||||||||||||||||||||
| 122 | 0 | my $target = shift; | |||||||||||||||||||||||||||||||
| 123 | |||||||||||||||||||||||||||||||||
| 124 | 0 | ▶ | if ( UNIVERSAL::can($target, 'm_get_values') ) { | ||||||||||||||||||||||||||||||
|
Branch: 4 branches
| |||||||||||||||||||||||||||||||||
| 125 | 0 | return $target->m_get_values(@_); | |||||||||||||||||||||||||||||||
| 126 | } elsif ( UNIVERSAL::isa($target, 'HASH') ) { | ||||||||||||||||||||||||||||||||
| 127 | 0 | return values %$target; | |||||||||||||||||||||||||||||||
| 128 | } elsif ( UNIVERSAL::isa($target, 'ARRAY') ) { | ||||||||||||||||||||||||||||||||
| 129 | 0 | return @$target; | |||||||||||||||||||||||||||||||
| 130 | } elsif ( ! ref $target ) { | ||||||||||||||||||||||||||||||||
| 131 | 0 | return $target; | |||||||||||||||||||||||||||||||
| 132 | } else { | ||||||||||||||||||||||||||||||||
| 133 | 0 | return (); | |||||||||||||||||||||||||||||||
| 134 | } | ||||||||||||||||||||||||||||||||
| 135 | } | ||||||||||||||||||||||||||||||||
| 136 | |||||||||||||||||||||||||||||||||
| 137 | # $value = get_value_for_key($target, $key); | ||||||||||||||||||||||||||||||||
| 138 | 29 | ▶ | sub get_value_for_key ($$) { | ||||||||||||||||||||||||||||||
|
Subroutine
get_value_for_key: called CC=10 SCAR=28.0
Pod
documented
| |||||||||||||||||||||||||||||||||
| 139 | 29 | my $target = shift; | |||||||||||||||||||||||||||||||
| 140 | 29 | ▶ | croak "get called without target \n" unless (defined $target); | ||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||
| 141 | |||||||||||||||||||||||||||||||||
| 142 | 29 | my $key = shift; | |||||||||||||||||||||||||||||||
| 143 | |||||||||||||||||||||||||||||||||
| 144 | 29 | ▶ | if ( UNIVERSAL::can($target, 'm_get_value_for_key') ) { | ||||||||||||||||||||||||||||||
|
Branch: 3 branches
| |||||||||||||||||||||||||||||||||
| 145 | 0 | return $target->m_get_value_for_key($key); | |||||||||||||||||||||||||||||||
| 146 | } elsif ( UNIVERSAL::isa($target, 'HASH') ) { | ||||||||||||||||||||||||||||||||
| 147 | 26 | ▶ | return $target->{$key} if (exists $target->{$key}); | ||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||
| 148 | } elsif ( UNIVERSAL::isa($target, 'ARRAY') ) { | ||||||||||||||||||||||||||||||||
| 149 | 3 | ▶ | carp "Use of non-numeric key '$key'" unless ( $key eq '0' or $key > 0 ); | ||||||||||||||||||||||||||||||
|
Branch: 1 branch
Condition66%2/3
$key eq 0 or $key > 0
MC/DC0%0/2
$key eq 0 or $key > 0
$key eq 0
$key > 0
Truth table66%2/3
A or B
A= $key eq 0B= $key > 0
| |||||||||||||||||||||||||||||||||
| 150 | 3 | ▶ | return $target->[$key] if ($key >= 0 and $key < scalar @$target); | ||||||||||||||||||||||||||||||
|
Branch: 1 branch
Condition33%1/3
$key >= 0 and $key < scalar @$target
MC/DC0%0/2
$key >= 0 and $key < scalar @$target
$key >= 0
$key < scalar @$target
Truth table33%1/3
A and B
A= $key >= 0B= $key < scalar @$target
| |||||||||||||||||||||||||||||||||
| 151 | } else { | ||||||||||||||||||||||||||||||||
| 152 | 0 | carp "'$target' can't get_value_for_key '$key'\n"; | |||||||||||||||||||||||||||||||
| 153 | } | ||||||||||||||||||||||||||||||||
| 154 | 0 | return undef; | |||||||||||||||||||||||||||||||
| 155 | } | ||||||||||||||||||||||||||||||||
| 156 | |||||||||||||||||||||||||||||||||
| 157 | # set_value_for_key($target, $key, $value); | ||||||||||||||||||||||||||||||||
| 158 | 5 | ▶ | sub set_value_for_key ($$$) { | ||||||||||||||||||||||||||||||
|
Subroutine
set_value_for_key: called CC=5 SCAR=21.7
Pod
documented
| |||||||||||||||||||||||||||||||||
| 159 | 5 | my $target = shift; | |||||||||||||||||||||||||||||||
| 160 | 5 | ▶ | croak "set_value_for_key called without target \n" unless (defined $target); | ||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||
| 161 | |||||||||||||||||||||||||||||||||
| 162 | 5 | ▶ | if ( UNIVERSAL::can($target, 'm_set_value_for_key') ) { | ||||||||||||||||||||||||||||||
|
Branch: 3 branches
| |||||||||||||||||||||||||||||||||
| 163 | 0 | return $target->m_set_value_for_key(@_); | |||||||||||||||||||||||||||||||
| 164 | } elsif ( UNIVERSAL::isa($target, 'HASH') ) { | ||||||||||||||||||||||||||||||||
| 165 | 5 | $target->{ $_[0] } = $_[1]; | |||||||||||||||||||||||||||||||
| 166 | } elsif ( UNIVERSAL::isa($target, 'ARRAY') ) { | ||||||||||||||||||||||||||||||||
| 167 | 0 | $target->[ $_[0] ] = $_[1]; | |||||||||||||||||||||||||||||||
| 168 | } else { | ||||||||||||||||||||||||||||||||
| 169 | # We do not natively support set() on anything else. | ||||||||||||||||||||||||||||||||
| 170 | 0 | carp "'$target' can't set_value_for_key '$_[0]'\n"; | |||||||||||||||||||||||||||||||
| 171 | } | ||||||||||||||||||||||||||||||||
| 172 | } | ||||||||||||||||||||||||||||||||
| 173 | |||||||||||||||||||||||||||||||||
| 174 | # $value = get_or_create_value_for_key($target, $key); | ||||||||||||||||||||||||||||||||
| 175 | 1 | ▶ | sub get_or_create_value_for_key { | ||||||||||||||||||||||||||||||
|
Subroutine
get_or_create_value_for_key: called CC=3 SCAR=12.0
Pod
documented
| |||||||||||||||||||||||||||||||||
| 176 | 1 | my $target = shift; | |||||||||||||||||||||||||||||||
| 177 | 1 | my $key = shift; | |||||||||||||||||||||||||||||||
| 178 | |||||||||||||||||||||||||||||||||
| 179 | 1 | ▶ | return $target->m_get_or_create_value_for_key($key) | ||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||
| 180 | if ( UNIVERSAL::can($target, 'm_get_or_create_value_for_key') ); | ||||||||||||||||||||||||||||||||
| 181 | |||||||||||||||||||||||||||||||||
| 182 | 1 | my $value = get_value_for_key($target, $key); | |||||||||||||||||||||||||||||||
| 183 | |||||||||||||||||||||||||||||||||
| 184 | 1 | ▶ | unless (defined $value) { | ||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||
| 185 | 0 | $value = {}; | |||||||||||||||||||||||||||||||
| 186 | 0 | set_value_for_key($target, $key, $value); | |||||||||||||||||||||||||||||||
| 187 | } | ||||||||||||||||||||||||||||||||
| 188 | |||||||||||||||||||||||||||||||||
| 189 | 1 | return $value; | |||||||||||||||||||||||||||||||
| 190 | } | ||||||||||||||||||||||||||||||||
| 191 | |||||||||||||||||||||||||||||||||
| 192 | # $value_reference = get_reference_for_key($target, $key); | ||||||||||||||||||||||||||||||||
| 193 | 0 | ▶ | sub get_reference_for_key ($$) { | ||||||||||||||||||||||||||||||
|
Subroutine
get_reference_for_key: not called CC=5 SCAR=34.0
Pod
documented
| |||||||||||||||||||||||||||||||||
| 194 | 0 | my $target = shift; | |||||||||||||||||||||||||||||||
| 195 | 0 | ▶ | croak "get_reference_for_key called w/o target\n" unless (defined $target); | ||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||
| 196 | |||||||||||||||||||||||||||||||||
| 197 | 0 | my $key = shift; | |||||||||||||||||||||||||||||||
| 198 | |||||||||||||||||||||||||||||||||
| 199 | 0 | ▶ | if ( UNIVERSAL::can($target, 'm_get_reference_for_key') ) { | ||||||||||||||||||||||||||||||
|
Branch: 3 branches
| |||||||||||||||||||||||||||||||||
| 200 | 0 | return $target->m_get_reference_for_key($key); | |||||||||||||||||||||||||||||||
| 201 | } elsif ( UNIVERSAL::isa($target, 'HASH') ) { | ||||||||||||||||||||||||||||||||
| 202 | 0 | return \${$target}{$key}; | |||||||||||||||||||||||||||||||
| 203 | } elsif ( UNIVERSAL::isa($target, 'ARRAY') ) { | ||||||||||||||||||||||||||||||||
| 204 | 0 | return \${$target}[$key]; | |||||||||||||||||||||||||||||||
| 205 | } else { | ||||||||||||||||||||||||||||||||
| 206 | 0 | carp "'$target' can't get_reference_for_key '$_[0]'\n"; | |||||||||||||||||||||||||||||||
| 207 | } | ||||||||||||||||||||||||||||||||
| 208 | } | ||||||||||||||||||||||||||||||||
| 209 | |||||||||||||||||||||||||||||||||
| 210 | ### Multiple-Key Chaining | ||||||||||||||||||||||||||||||||
| 211 | # | ||||||||||||||||||||||||||||||||
| 212 | # These functions allow access through a series of keys. Generally, the list | ||||||||||||||||||||||||||||||||
| 213 | # of keys is interpreted each starting from the result of the previous one. | ||||||||||||||||||||||||||||||||
| 214 | |||||||||||||||||||||||||||||||||
| 215 | # $value = get_value_for_keys($target, @keys); | ||||||||||||||||||||||||||||||||
| 216 | 17 | ▶ | sub get_value_for_keys ($@) { | ||||||||||||||||||||||||||||||
|
Subroutine
get_value_for_keys: called CC=7 SCAR=20.2
Pod
documented
| |||||||||||||||||||||||||||||||||
| 217 | 17 | my $target = shift; | |||||||||||||||||||||||||||||||
| 218 | 17 | ▶ | croak "get_value_for_keys called without target \n" unless (defined $target); | ||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||
| 219 | 17 | ▶ | croak "get_value_for_keys called without keys \n" unless (scalar @_); | ||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||
| 220 | |||||||||||||||||||||||||||||||||
| 221 | 17 | ▶ | while ( scalar @_ ) { | ||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||
| 222 | # If we've got keys remaining, use the appropriate get method... | ||||||||||||||||||||||||||||||||
| 223 | 28 | ▶ | return $target->m_get_value_for_keys(@_) | ||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||
| 224 | if UNIVERSAL::can($target, 'm_get_value_for_keys'); | ||||||||||||||||||||||||||||||||
| 225 | |||||||||||||||||||||||||||||||||
| 226 | 28 | my $key = shift @_; | |||||||||||||||||||||||||||||||
| 227 | 28 | my $result = get_value_for_key($target, $key); | |||||||||||||||||||||||||||||||
| 228 | |||||||||||||||||||||||||||||||||
| 229 | # If there aren't any more keys, we're done! | ||||||||||||||||||||||||||||||||
| 230 | 28 | ▶ | return $result unless (scalar @_); | ||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||
| 231 | |||||||||||||||||||||||||||||||||
| 232 | # We can't keep going without a ref value, despite the remaining keys | ||||||||||||||||||||||||||||||||
| 233 | 11 | ▶ | return undef unless (ref $result); | ||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||
| 234 | |||||||||||||||||||||||||||||||||
| 235 | # ... or select the target and iterate through another key | ||||||||||||||||||||||||||||||||
| 236 | 11 | $target = $result; | |||||||||||||||||||||||||||||||
| 237 | } | ||||||||||||||||||||||||||||||||
| 238 | } | ||||||||||||||||||||||||||||||||
| 239 | |||||||||||||||||||||||||||||||||
| 240 | # set_value_for_keys($target, $value, @keys); | ||||||||||||||||||||||||||||||||
| 241 | 5 | ▶ | sub set_value_for_keys { | ||||||||||||||||||||||||||||||
|
Subroutine
set_value_for_keys: called CC=7 SCAR=20.2
Pod
documented
| |||||||||||||||||||||||||||||||||
| 242 | 5 | my $target = shift; | |||||||||||||||||||||||||||||||
| 243 | 5 | my $value = shift; | |||||||||||||||||||||||||||||||
| 244 | |||||||||||||||||||||||||||||||||
| 245 | 5 | ▶ | croak "set_value_for_keys called without target \n" unless (defined $target); | ||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||
| 246 | 5 | ▶ | croak "set_value_for_keys called without keys \n" unless (scalar @_); | ||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||
| 247 | |||||||||||||||||||||||||||||||||
| 248 | 5 | ▶ | while ( scalar @_ ) { | ||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||
| 249 | 6 | ▶ | return $target->m_set_value_for_keys($value, @_) | ||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||
| 250 | if UNIVERSAL::can($target, 'm_set_value_for_keys'); | ||||||||||||||||||||||||||||||||
| 251 | |||||||||||||||||||||||||||||||||
| 252 | 6 | my $key = shift @_; | |||||||||||||||||||||||||||||||
| 253 | |||||||||||||||||||||||||||||||||
| 254 | # Last key -- we're at the end of the line | ||||||||||||||||||||||||||||||||
| 255 | 6 | ▶ | return set_value_for_key($target, $key, $value) unless (scalar @_); | ||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||
| 256 | |||||||||||||||||||||||||||||||||
| 257 | # Get the value for this key, or create an empty hash ref to build into. | ||||||||||||||||||||||||||||||||
| 258 | 1 | my $result = get_or_create_value_for_key($target, $key); | |||||||||||||||||||||||||||||||
| 259 | |||||||||||||||||||||||||||||||||
| 260 | # We've got keys remaining, but we can't keep going | ||||||||||||||||||||||||||||||||
| 261 | 1 | ▶ | return undef unless (ref $result); | ||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||
| 262 | |||||||||||||||||||||||||||||||||
| 263 | 1 | $target = $result; | |||||||||||||||||||||||||||||||
| 264 | } | ||||||||||||||||||||||||||||||||
| 265 | } | ||||||||||||||||||||||||||||||||
| 266 | |||||||||||||||||||||||||||||||||
| 267 | # $value = get_or_create_value_for_keys($target, @keys); | ||||||||||||||||||||||||||||||||
| 268 | 0 | ▶ | sub get_or_create_value_for_keys { | ||||||||||||||||||||||||||||||
|
Subroutine
get_or_create_value_for_keys: not called CC=7 SCAR=40.3
Pod
documented
| |||||||||||||||||||||||||||||||||
| 269 | 0 | my $target = shift; | |||||||||||||||||||||||||||||||
| 270 | 0 | my $value = shift; | |||||||||||||||||||||||||||||||
| 271 | |||||||||||||||||||||||||||||||||
| 272 | 0 | ▶ | croak "set_value_for_keys called without target \n" unless (defined $target); | ||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||
| 273 | 0 | ▶ | croak "set_value_for_keys called without keys \n" unless (scalar @_); | ||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||
| 274 | |||||||||||||||||||||||||||||||||
| 275 | 0 | ▶ | while ( scalar @_ ) { | ||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||
| 276 | 0 | ▶ | return $target->m_get_or_create_value_for_keys($value, @_) | ||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||
| 277 | if UNIVERSAL::can($target, 'm_get_or_create_value_for_keys'); | ||||||||||||||||||||||||||||||||
| 278 | |||||||||||||||||||||||||||||||||
| 279 | 0 | my $key = shift @_; | |||||||||||||||||||||||||||||||
| 280 | 0 | my $result = get_or_create_value_for_key($target, $key); | |||||||||||||||||||||||||||||||
| 281 | |||||||||||||||||||||||||||||||||
| 282 | # If there aren't any more keys, we're done! | ||||||||||||||||||||||||||||||||
| 283 | 0 | ▶ | return $result unless (scalar @_); | ||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||
| 284 | |||||||||||||||||||||||||||||||||
| 285 | # We can't keep going without a ref value, despite the remaining keys | ||||||||||||||||||||||||||||||||
| 286 | 0 | ▶ | return undef unless (ref $result); | ||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||
| 287 | |||||||||||||||||||||||||||||||||
| 288 | # ... or select the target and iterate through another key | ||||||||||||||||||||||||||||||||
| 289 | 0 | $target = $result; | |||||||||||||||||||||||||||||||
| 290 | } | ||||||||||||||||||||||||||||||||
| 291 | } | ||||||||||||||||||||||||||||||||
| 292 | |||||||||||||||||||||||||||||||||
| 293 | # $val_ref = get_reference_for_keys($target, @keys); | ||||||||||||||||||||||||||||||||
| 294 | 0 | ▶ | sub get_reference_for_keys { | ||||||||||||||||||||||||||||||
|
Subroutine
get_reference_for_keys: not called CC=7 SCAR=40.3
Pod
documented
| |||||||||||||||||||||||||||||||||
| 295 | 0 | my $target = shift; | |||||||||||||||||||||||||||||||
| 296 | |||||||||||||||||||||||||||||||||
| 297 | 0 | ▶ | croak "get_reference_for_keys called w/o target\n" unless (defined $target); | ||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||
| 298 | 0 | ▶ | croak "get_reference_for_keys called w/o keys \n" unless (scalar @_); | ||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||
| 299 | |||||||||||||||||||||||||||||||||
| 300 | 0 | ▶ | while ( scalar @_ ) { | ||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||
| 301 | 0 | ▶ | return $target->m_get_reference_for_keys(@_) | ||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||
| 302 | if UNIVERSAL::can($target, 'm_get_reference_for_keys'); | ||||||||||||||||||||||||||||||||
| 303 | |||||||||||||||||||||||||||||||||
| 304 | 0 | my $key = shift @_; | |||||||||||||||||||||||||||||||
| 305 | |||||||||||||||||||||||||||||||||
| 306 | # Last key -- we're at the end of the line | ||||||||||||||||||||||||||||||||
| 307 | 0 | ▶ | return get_reference_for_key($target, $key) unless (scalar @_); | ||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||
| 308 | |||||||||||||||||||||||||||||||||
| 309 | # Get the value for this key, or create an empty hash ref to build into. | ||||||||||||||||||||||||||||||||
| 310 | 0 | my $result = get_or_create_value_for_key($target, $key); | |||||||||||||||||||||||||||||||
| 311 | |||||||||||||||||||||||||||||||||
| 312 | # We've got keys remaining, but we can't keep going | ||||||||||||||||||||||||||||||||
| 313 | 0 | ▶ | return undef unless (ref $result); | ||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||
| 314 | |||||||||||||||||||||||||||||||||
| 315 | 0 | $target = $result; | |||||||||||||||||||||||||||||||
| 316 | } | ||||||||||||||||||||||||||||||||
| 317 | } | ||||||||||||||||||||||||||||||||
| 318 | |||||||||||||||||||||||||||||||||
| 319 | ### DRef Syntax | ||||||||||||||||||||||||||||||||
| 320 | # | ||||||||||||||||||||||||||||||||
| 321 | # DRef strings are dot-separated | ||||||||||||||||||||||||||||||||
| 322 | |||||||||||||||||||||||||||||||||
| 323 | # $Separator - Multiple-key delimiter character | ||||||||||||||||||||||||||||||||
| 324 | 2 | ▶ | use vars qw( $Separator $DRefPrefix ); | ||||||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||||||
| 325 | 2 | $Separator = '.'; | |||||||||||||||||||||||||||||||
| 326 | 2 | $DRefPrefix = '#'; | |||||||||||||||||||||||||||||||
| 327 | |||||||||||||||||||||||||||||||||
| 328 | # @drefs = get_key_drefs($target); | ||||||||||||||||||||||||||||||||
| 329 | 3 | ▶ | sub get_key_drefs { | ||||||||||||||||||||||||||||||
|
Subroutine
get_key_drefs: called CC=1 SCAR=0.0
Pod
documented
| |||||||||||||||||||||||||||||||||
| 330 | 3 | map { printable($_) } get_keys( @_ ); | |||||||||||||||||||||||||||||||
| 331 | } | ||||||||||||||||||||||||||||||||
| 332 | |||||||||||||||||||||||||||||||||
| 333 | # $dref = dref_from_keys( @keys ); | ||||||||||||||||||||||||||||||||
| 334 | # Return a dref composed of a list of $Separator-protected keys | ||||||||||||||||||||||||||||||||
| 335 | 0 | ▶ | sub dref_from_keys (@) { | ||||||||||||||||||||||||||||||
|
Subroutine
dref_from_keys: not called CC=1 SCAR=6.9
Pod
documented
| |||||||||||||||||||||||||||||||||
| 336 | 0 | join $Separator, map { printable($_) } @_; | |||||||||||||||||||||||||||||||
| 337 | } | ||||||||||||||||||||||||||||||||
| 338 | |||||||||||||||||||||||||||||||||
| 339 | # @keys = keys_from_dref( $dref ); | ||||||||||||||||||||||||||||||||
| 340 | # Return a series of key strings extracted from a dref | ||||||||||||||||||||||||||||||||
| 341 | 22 | ▶ | sub keys_from_dref ($) { | ||||||||||||||||||||||||||||||
|
Subroutine
keys_from_dref: called CC=3 SCAR=11.0
Pod
documented
| |||||||||||||||||||||||||||||||||
| 342 | 22 | my $dref = shift; | |||||||||||||||||||||||||||||||
| 343 | 22 | my @keys; | |||||||||||||||||||||||||||||||
| 344 | 22 | ▶ | while ( defined $dref and length $dref ) { | ||||||||||||||||||||||||||||||
|
Branch: 1 branch
Condition66%2/3
defined $dref and length $dref
MC/DC50%1/2
defined $dref and length $dref
defined $dref
length $dref
Truth table66%2/3
A and B
A= defined $drefB= length $dref
| |||||||||||||||||||||||||||||||||
| 345 | 34 | $dref =~ s/\A((?:[^\\\Q$Separator\E]+|\\.)*)(?:\Q$Separator\E|\Z)//m; | |||||||||||||||||||||||||||||||
| 346 | 34 | push(@keys, unprintable($1)); | |||||||||||||||||||||||||||||||
| 347 | } | ||||||||||||||||||||||||||||||||
| 348 | 22 | return @keys; | |||||||||||||||||||||||||||||||
| 349 | } | ||||||||||||||||||||||||||||||||
| 350 | |||||||||||||||||||||||||||||||||
| 351 | # $dref = join_drefs( @drefs ); | ||||||||||||||||||||||||||||||||
| 352 | 2 | ▶ | sub join_drefs (@) { | ||||||||||||||||||||||||||||||
|
Subroutine
join_drefs: called CC=1 SCAR=0.0
Pod
documented
| |||||||||||||||||||||||||||||||||
| 353 | 2 | join($Separator, @_); | |||||||||||||||||||||||||||||||
| 354 | } | ||||||||||||||||||||||||||||||||
| 355 | |||||||||||||||||||||||||||||||||
| 356 | # unshift_dref_key( $dref, $key ); | ||||||||||||||||||||||||||||||||
| 357 | # Prepends key to dref -- modifies value of first argument | ||||||||||||||||||||||||||||||||
| 358 | 0 | ▶ | sub unshift_dref_key { | ||||||||||||||||||||||||||||||
|
Subroutine
unshift_dref_key: not called CC=1 SCAR=6.9
Pod
documented
| |||||||||||||||||||||||||||||||||
| 359 | 0 | $_[0] = join($Separator, unprintable($_[1]), $_[0]); | |||||||||||||||||||||||||||||||
| 360 | } | ||||||||||||||||||||||||||||||||
| 361 | |||||||||||||||||||||||||||||||||
| 362 | # $key = shift_dref_key( $dref ); | ||||||||||||||||||||||||||||||||
| 363 | # Removes first key from dref -- modifies value of its argument | ||||||||||||||||||||||||||||||||
| 364 | 0 | ▶ | sub shift_dref_key { | ||||||||||||||||||||||||||||||
|
Subroutine
shift_dref_key: not called CC=1 SCAR=6.9
Pod
documented
| |||||||||||||||||||||||||||||||||
| 365 | 0 | $_[0] =~ s/\A((?:[^\\\Q$Separator\E]+|\\.)*)(?:\Q$Separator\E|\Z)//m; | |||||||||||||||||||||||||||||||
| 366 | 0 | return unprintable($1); | |||||||||||||||||||||||||||||||
| 367 | } | ||||||||||||||||||||||||||||||||
| 368 | |||||||||||||||||||||||||||||||||
| 369 | # $dref = resolve_pragmas( $dref_with_embedded_parens ); | ||||||||||||||||||||||||||||||||
| 370 | # ($dref, %options) = resolve_pragmas( $dref_with_embedded_parens ); | ||||||||||||||||||||||||||||||||
| 371 | 22 | ▶ | sub resolve_pragmas ($) { | ||||||||||||||||||||||||||||||
|
Subroutine
resolve_pragmas: called CC=3 SCAR=12.0
Pod
documented
| |||||||||||||||||||||||||||||||||
| 372 | 22 | my $path = shift; | |||||||||||||||||||||||||||||||
| 373 | 22 | my $options = {}; | |||||||||||||||||||||||||||||||
| 374 | |||||||||||||||||||||||||||||||||
| 375 | 22 | ▶ | do {} while ( | ||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||
| 376 | $path =~ s/(\A|[^\\]|[^\\](?:\\{2})*)\(([\#\!])([^\(\)]+)\) | ||||||||||||||||||||||||||||||||
| 377 | 0 | /$1._expand_pragma($2, $3, $options)/ex | |||||||||||||||||||||||||||||||
| 378 | ); | ||||||||||||||||||||||||||||||||
| 379 | |||||||||||||||||||||||||||||||||
| 380 | 22 | ▶ | return wantarray ? ($path, %$options) : $path; | ||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||
| 381 | } | ||||||||||||||||||||||||||||||||
| 382 | |||||||||||||||||||||||||||||||||
| 383 | 0 | ▶ | sub _expand_pragma { | ||||||||||||||||||||||||||||||
|
Subroutine
_expand_pragma: not called CC=3 SCAR=24.8
| |||||||||||||||||||||||||||||||||
| 384 | 0 | my ($type, $value, $options) = @_; | |||||||||||||||||||||||||||||||
| 385 | 0 | ▶ | if ( $type eq $DRefPrefix ) { | ||||||||||||||||||||||||||||||
|
Branch: 2 branches
| |||||||||||||||||||||||||||||||||
| 386 | 0 | return get_value_for_root_dref($value); | |||||||||||||||||||||||||||||||
| 387 | } elsif ( $type eq '!' ) { | ||||||||||||||||||||||||||||||||
| 388 | 0 | $options->{ $value } = 1; | |||||||||||||||||||||||||||||||
| 389 | } else { | ||||||||||||||||||||||||||||||||
| 390 | 0 | carp "use of unsupported DRef pragma '$type$value'"; | |||||||||||||||||||||||||||||||
| 391 | } | ||||||||||||||||||||||||||||||||
| 392 | 0 | return ''; | |||||||||||||||||||||||||||||||
| 393 | } | ||||||||||||||||||||||||||||||||
| 394 | |||||||||||||||||||||||||||||||||
| 395 | ### DRef Access | ||||||||||||||||||||||||||||||||
| 396 | |||||||||||||||||||||||||||||||||
| 397 | # $value = get_value_for_dref($target, $dref); | ||||||||||||||||||||||||||||||||
| 398 | 17 | ▶ | sub get_value_for_dref { | ||||||||||||||||||||||||||||||
|
Subroutine
get_value_for_dref: called CC=1 SCAR=0.0
Pod
documented
| |||||||||||||||||||||||||||||||||
| 399 | 17 | get_value_for_keys $_[0], keys_from_dref( (resolve_pragmas($_[1]))[0] ); | |||||||||||||||||||||||||||||||
| 400 | } | ||||||||||||||||||||||||||||||||
| 401 | |||||||||||||||||||||||||||||||||
| 402 | # set_value_for_dref($target, $dref, $value); | ||||||||||||||||||||||||||||||||
| 403 | 5 | ▶ | sub set_value_for_dref { | ||||||||||||||||||||||||||||||
|
Subroutine
set_value_for_dref: called CC=1 SCAR=0.0
Pod
documented
| |||||||||||||||||||||||||||||||||
| 404 | 5 | set_value_for_keys $_[0], $_[2], keys_from_dref((resolve_pragmas($_[1]))[0]); | |||||||||||||||||||||||||||||||
| 405 | } | ||||||||||||||||||||||||||||||||
| 406 | |||||||||||||||||||||||||||||||||
| 407 | ### Shared Data Graph Entry | ||||||||||||||||||||||||||||||||
| 408 | |||||||||||||||||||||||||||||||||
| 409 | # $Root - Data graph entry point | ||||||||||||||||||||||||||||||||
| 410 | 2 | ▶ | use vars qw( $Root ); | ||||||||||||||||||||||||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||||||||||||||||||||||||
| 411 | 2 | $Root = {}; | |||||||||||||||||||||||||||||||
| 412 | |||||||||||||||||||||||||||||||||
| 413 | # $value = get_value_for_root_dref($dref); | ||||||||||||||||||||||||||||||||
| 414 | 11 | ▶ | sub get_value_for_root_dref ($) { | ||||||||||||||||||||||||||||||
|
Subroutine
get_value_for_root_dref: called CC=1 SCAR=0.0
Pod
documented
| |||||||||||||||||||||||||||||||||
| 415 | 11 | get_value_for_dref($Root, @_) | |||||||||||||||||||||||||||||||
| 416 | } | ||||||||||||||||||||||||||||||||
| 417 | |||||||||||||||||||||||||||||||||
| 418 | # $value = set_value_for_root_dref($dref, $value); | ||||||||||||||||||||||||||||||||
| 419 | 5 | ▶ | sub set_value_for_root_dref ($$) { | ||||||||||||||||||||||||||||||
|
Subroutine
set_value_for_root_dref: called CC=1 SCAR=0.0
Pod
documented
| |||||||||||||||||||||||||||||||||
| 420 | 5 | set_value_for_dref($Root, @_) | |||||||||||||||||||||||||||||||
| 421 | } | ||||||||||||||||||||||||||||||||
| 422 | |||||||||||||||||||||||||||||||||
| 423 | # $value = get_value_for_optional_dref($literal_or_dref_with_leading_hashmark); | ||||||||||||||||||||||||||||||||
| 424 | 0 | ▶ | sub get_value_for_optional_dref ($) { | ||||||||||||||||||||||||||||||
|
Subroutine
get_value_for_optional_dref: not called CC=2 SCAR=17.9
Pod
documented
| |||||||||||||||||||||||||||||||||
| 425 | 0 | ▶ | $_[0] =~ /^\Q$DRefPrefix\E(.*)/o ? get_value_for_root_dref($1) : $_[0] | ||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||
| 426 | } | ||||||||||||||||||||||||||||||||
| 427 | |||||||||||||||||||||||||||||||||
| 428 | ### Select by DRefs | ||||||||||||||||||||||||||||||||
| 429 | |||||||||||||||||||||||||||||||||
| 430 | # $key or @keys = matching_keys($target, %dref_value_criteria_pairs); | ||||||||||||||||||||||||||||||||
| 431 | 0 | ▶ | sub matching_keys { | ||||||||||||||||||||||||||||||
|
Subroutine
matching_keys: not called CC=9 SCAR=45.0
Pod
documented
| |||||||||||||||||||||||||||||||||
| 432 | 0 | my($target, %kvp_criteria) = @_; | |||||||||||||||||||||||||||||||
| 433 | 0 | ▶ | return unless ($target and scalar %kvp_criteria); | ||||||||||||||||||||||||||||||
|
Branch: 1 branch
Condition0%0/2
$target and scalar %kvp_criteria
MC/DC0%0/1
$target and scalar %kvp_criteria
$target
Truth table0%0/2
A
A= $target
| |||||||||||||||||||||||||||||||||
| 434 | 0 | my ($key, $dref, @keys); | |||||||||||||||||||||||||||||||
| 435 | 0 | ITEM: foreach $key (get_keys $target) { | |||||||||||||||||||||||||||||||
| 436 | 0 | my $item = get_value_for_key($target,$key); | |||||||||||||||||||||||||||||||
| 437 | 0 | foreach $dref (keys %kvp_criteria) { | |||||||||||||||||||||||||||||||
| 438 | 0 | ▶ | next ITEM unless $kvp_criteria{$dref} eq ( | ||||||||||||||||||||||||||||||
|
Branch: 2 branches
Condition0%0/3
defined $dref and length $dref
MC/DC0%0/2
defined $dref and length $dref
defined $dref
length $dref
Truth table0%0/3
A and B
A= defined $drefB= length $dref
| |||||||||||||||||||||||||||||||||
| 439 | defined $dref && length $dref ? get_value_for_dref($item,$dref) : $item | ||||||||||||||||||||||||||||||||
| 440 | ); | ||||||||||||||||||||||||||||||||
| 441 | } | ||||||||||||||||||||||||||||||||
| 442 | 0 | ▶ | return $key unless (wantarray); | ||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||
| 443 | 0 | push @keys, $key; | |||||||||||||||||||||||||||||||
| 444 | } | ||||||||||||||||||||||||||||||||
| 445 | 0 | return @keys; | |||||||||||||||||||||||||||||||
| 446 | } | ||||||||||||||||||||||||||||||||
| 447 | |||||||||||||||||||||||||||||||||
| 448 | # $item or @items = matching_values($target, %dref_value_criteria_pairs); | ||||||||||||||||||||||||||||||||
| 449 | 0 | ▶ | sub matching_values { | ||||||||||||||||||||||||||||||
|
Subroutine
matching_values: not called CC=7 SCAR=40.3
Pod
documented
| |||||||||||||||||||||||||||||||||
| 450 | 0 | my($target, %kvp_criteria) = @_; | |||||||||||||||||||||||||||||||
| 451 | 0 | my($item, $dref, @items); | |||||||||||||||||||||||||||||||
| 452 | 0 | ITEM: foreach $item ( get_values($target) ) { | |||||||||||||||||||||||||||||||
| 453 | 0 | foreach $dref (keys %kvp_criteria) { | |||||||||||||||||||||||||||||||
| 454 | 0 | ▶ | next ITEM unless $kvp_criteria{$dref} eq ( | ||||||||||||||||||||||||||||||
|
Branch: 2 branches
Condition0%0/3
defined $dref and length $dref
MC/DC0%0/2
defined $dref and length $dref
defined $dref
length $dref
Truth table0%0/3
A and B
A= defined $drefB= length $dref
| |||||||||||||||||||||||||||||||||
| 455 | defined $dref && length $dref ? get_value_for_dref($item,$dref) : $item | ||||||||||||||||||||||||||||||||
| 456 | ); | ||||||||||||||||||||||||||||||||
| 457 | } | ||||||||||||||||||||||||||||||||
| 458 | 0 | ▶ | return $item unless (wantarray); | ||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||
| 459 | 0 | push @items, $item; | |||||||||||||||||||||||||||||||
| 460 | } | ||||||||||||||||||||||||||||||||
| 461 | 0 | return @items; | |||||||||||||||||||||||||||||||
| 462 | } | ||||||||||||||||||||||||||||||||
| 463 | |||||||||||||||||||||||||||||||||
| 464 | ### Index by DRefs | ||||||||||||||||||||||||||||||||
| 465 | |||||||||||||||||||||||||||||||||
| 466 | # $index = index_by_drefs($target, @drefs) | ||||||||||||||||||||||||||||||||
| 467 | 0 | ▶ | sub index_by_drefs { | ||||||||||||||||||||||||||||||
|
Subroutine
index_by_drefs: not called CC=2 SCAR=17.9
Pod
documented
| |||||||||||||||||||||||||||||||||
| 468 | 0 | my($target, @drefs) = @_; | |||||||||||||||||||||||||||||||
| 469 | 0 | my $index = {}; | |||||||||||||||||||||||||||||||
| 470 | |||||||||||||||||||||||||||||||||
| 471 | 0 | my $item; | |||||||||||||||||||||||||||||||
| 472 | 0 | foreach $item ( get_values($target) ) { | |||||||||||||||||||||||||||||||
| 473 | 0 | my @keys = map { get_value_for_dref($item, $_) } @drefs; | |||||||||||||||||||||||||||||||
| 474 | 0 | my $grouping = get_reference_for_keys($index, @keys); | |||||||||||||||||||||||||||||||
| 475 | 0 | push @$$grouping, $item; | |||||||||||||||||||||||||||||||
| 476 | } | ||||||||||||||||||||||||||||||||
| 477 | |||||||||||||||||||||||||||||||||
| 478 | 0 | return $index; | |||||||||||||||||||||||||||||||
| 479 | } | ||||||||||||||||||||||||||||||||
| 480 | |||||||||||||||||||||||||||||||||
| 481 | # $index = unique_index_by_drefs($target, @drefs) | ||||||||||||||||||||||||||||||||
| 482 | 0 | ▶ | sub unique_index_by_drefs { | ||||||||||||||||||||||||||||||
|
Subroutine
unique_index_by_drefs: not called CC=2 SCAR=17.9
Pod
documented
| |||||||||||||||||||||||||||||||||
| 483 | 0 | my($target, @drefs) = @_; | |||||||||||||||||||||||||||||||
| 484 | 0 | my $index = {}; | |||||||||||||||||||||||||||||||
| 485 | |||||||||||||||||||||||||||||||||
| 486 | 0 | my $item; | |||||||||||||||||||||||||||||||
| 487 | 0 | foreach $item (get_values ($target)) { | |||||||||||||||||||||||||||||||
| 488 | 0 | my @keys = map { get_value_for_dref($item, $_) } @drefs; | |||||||||||||||||||||||||||||||
| 489 | 0 | set_value_for_keys($index, $item, @keys); | |||||||||||||||||||||||||||||||
| 490 | } | ||||||||||||||||||||||||||||||||
| 491 | |||||||||||||||||||||||||||||||||
| 492 | 0 | return $index; | |||||||||||||||||||||||||||||||
| 493 | } | ||||||||||||||||||||||||||||||||
| 494 | |||||||||||||||||||||||||||||||||
| 495 | # $entry_ary = ordered_index_by_drefs( $target, $index_dref ); | ||||||||||||||||||||||||||||||||
| 496 | 0 | ▶ | sub ordered_index_by_drefs { | ||||||||||||||||||||||||||||||
|
Subroutine
ordered_index_by_drefs: not called CC=4 SCAR=30.0
Pod
documented
| |||||||||||||||||||||||||||||||||
| 497 | 0 | my($target, $grouper) = @_; | |||||||||||||||||||||||||||||||
| 498 | 0 | my $index = {}; | |||||||||||||||||||||||||||||||
| 499 | 0 | my $order = []; | |||||||||||||||||||||||||||||||
| 500 | |||||||||||||||||||||||||||||||||
| 501 | 0 | my $item; | |||||||||||||||||||||||||||||||
| 502 | 0 | foreach $item ( get_values($target) ) { | |||||||||||||||||||||||||||||||
| 503 | 0 | my $value = get_value_for_dref($item, $grouper); | |||||||||||||||||||||||||||||||
| 504 | 0 | ▶ | $value = '' unless (defined $value); | ||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||
| 505 | push @$order, ( | ||||||||||||||||||||||||||||||||
| 506 | $index->{$value} = { 'value' => $value, 'items' => [] } | ||||||||||||||||||||||||||||||||
| 507 | 0 | ▶ | ) unless ( exists($index->{ $value }) ); | ||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||
| 508 | 0 | push @{ $index->{ $value }{'items'} }, $item; | |||||||||||||||||||||||||||||||
| 509 | } | ||||||||||||||||||||||||||||||||
| 510 | 0 | return $order; | |||||||||||||||||||||||||||||||
| 511 | } | ||||||||||||||||||||||||||||||||
| 512 | |||||||||||||||||||||||||||||||||
| 513 | ### DRefs to Leaf nodes | ||||||||||||||||||||||||||||||||
| 514 | |||||||||||||||||||||||||||||||||
| 515 | # @drefs = leaf_drefs($target); | ||||||||||||||||||||||||||||||||
| 516 | # Returns a list of drefs for non-ref leaves in a referenced structure. | ||||||||||||||||||||||||||||||||
| 517 | # Keep track of items we've visited previously to protect against loops. | ||||||||||||||||||||||||||||||||
| 518 | 1 | ▶ | sub leaf_drefs ($) { | ||||||||||||||||||||||||||||||
|
Subroutine
leaf_drefs: called CC=5 SCAR=16.1
Pod
documented
| |||||||||||||||||||||||||||||||||
| 519 | 1 | my $target = shift; | |||||||||||||||||||||||||||||||
| 520 | 1 | my @drefs = get_key_drefs( $target ); | |||||||||||||||||||||||||||||||
| 521 | 1 | my %visited; | |||||||||||||||||||||||||||||||
| 522 | my $i; | ||||||||||||||||||||||||||||||||
| 523 | 1 | ▶ | for ( $i = 0; $i <= $#drefs; $i++ ) { | ||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||
| 524 | 4 | my $dref = $drefs[$i]; | |||||||||||||||||||||||||||||||
| 525 | 4 | my $value = get_value_for_dref($target, $dref); | |||||||||||||||||||||||||||||||
| 526 | 4 | ▶ | next if ( ! ref $value or $visited{$value}++ ); | ||||||||||||||||||||||||||||||
|
Branch: 1 branch
Condition66%2/3
not ref $value or $visited{$value}++
MC/DC50%1/2
not ref $value or $visited{$value}++
not ref $value
$visited{$value}++
Truth table66%2/3
not(A) or B
A= not ref $valueB= $visited{$value}++
| |||||||||||||||||||||||||||||||||
| 527 | 2 | my @subkeys = get_key_drefs( $value ); | |||||||||||||||||||||||||||||||
| 528 | 2 | ▶ | if ( scalar @subkeys ) { | ||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||
| 529 | 2 | splice @drefs, $i, 1, map { join_drefs($dref, $_) } @subkeys; | |||||||||||||||||||||||||||||||
| 530 | 2 | $i--; | |||||||||||||||||||||||||||||||
| 531 | } | ||||||||||||||||||||||||||||||||
| 532 | } | ||||||||||||||||||||||||||||||||
| 533 | 1 | return @drefs; | |||||||||||||||||||||||||||||||
| 534 | } | ||||||||||||||||||||||||||||||||
| 535 | |||||||||||||||||||||||||||||||||
| 536 | # @values = leaf_values( $target ) | ||||||||||||||||||||||||||||||||
| 537 | 0 | ▶ | sub leaf_values ($) { | ||||||||||||||||||||||||||||||
|
Subroutine
leaf_values: not called CC=1 SCAR=6.9
Pod
documented
| |||||||||||||||||||||||||||||||||
| 538 | 0 | my $target = shift; | |||||||||||||||||||||||||||||||
| 539 | 0 | map { get_value_for_dref($target, $_) } leaf_drefs( $target ); | |||||||||||||||||||||||||||||||
| 540 | } | ||||||||||||||||||||||||||||||||
| 541 | |||||||||||||||||||||||||||||||||
| 542 | # %dref_value_pairs = leaf_drefs_and_values( $target ) | ||||||||||||||||||||||||||||||||
| 543 | 1 | ▶ | sub leaf_drefs_and_values ($) { | ||||||||||||||||||||||||||||||
|
Subroutine
leaf_drefs_and_values: called CC=1 SCAR=0.0
Pod
documented
| |||||||||||||||||||||||||||||||||
| 544 | 1 | my $target = shift; | |||||||||||||||||||||||||||||||
| 545 | 1 | map { $_, get_value_for_dref($target, $_) } leaf_drefs( $target ); | |||||||||||||||||||||||||||||||
| 546 | } | ||||||||||||||||||||||||||||||||
| 547 | |||||||||||||||||||||||||||||||||
| 548 | ### Compatiblity | ||||||||||||||||||||||||||||||||
| 549 | |||||||||||||||||||||||||||||||||
| 550 | 2 | *get = *get_value_for_dref; | |||||||||||||||||||||||||||||||
| 551 | 2 | *set = *set_value_for_dref; | |||||||||||||||||||||||||||||||
| 552 | 2 | *getDRef = *get_value_for_dref; | |||||||||||||||||||||||||||||||
| 553 | 2 | *setDRef = *set_value_for_dref; | |||||||||||||||||||||||||||||||
| 554 | 2 | *getData = *get_value_for_root_dref; | |||||||||||||||||||||||||||||||
| 555 | 2 | *setData = *set_value_for_root_dref; | |||||||||||||||||||||||||||||||
| 556 | 2 | *splitdref = *keys_from_dref; | |||||||||||||||||||||||||||||||
| 557 | 2 | *joindref = *dref_from_keys; | |||||||||||||||||||||||||||||||
| 558 | 2 | *shiftdref = *shift_dref_key; | |||||||||||||||||||||||||||||||
| 559 | 2 | *keysof = *get_keys; | |||||||||||||||||||||||||||||||
| 560 | 2 | *valuesof = *get_values; | |||||||||||||||||||||||||||||||
| 561 | 2 | *indexby = *index_by_drefs; | |||||||||||||||||||||||||||||||
| 562 | 2 | *uniqueindexby = *unique_index_by_drefs; | |||||||||||||||||||||||||||||||
| 563 | 2 | *orderedindexby = *ordered_index_by_drefs; | |||||||||||||||||||||||||||||||
| 564 | 2 | *scalarkeysof = *leaf_drefs; | |||||||||||||||||||||||||||||||
| 565 | 2 | *scalarkeysandvalues = *leaf_drefs_and_values; | |||||||||||||||||||||||||||||||
| 566 | |||||||||||||||||||||||||||||||||
| 567 | ### Data::DRef::MethodBased | ||||||||||||||||||||||||||||||||
| 568 | |||||||||||||||||||||||||||||||||
| 569 | package Data::DRef::MethodBased; | ||||||||||||||||||||||||||||||||
| 570 | |||||||||||||||||||||||||||||||||
| 571 | ### Minimal DRef Interface for Object Methods | ||||||||||||||||||||||||||||||||
| 572 | |||||||||||||||||||||||||||||||||
| 573 | # @keys = $target->m_get_keys() | ||||||||||||||||||||||||||||||||
| 574 | 0 | ▶ | sub m_get_keys { | ||||||||||||||||||||||||||||||
|
Subroutine
m_get_keys: not called CC=1 SCAR=6.9
| |||||||||||||||||||||||||||||||||
| 575 | 0 | return (); | |||||||||||||||||||||||||||||||
| 576 | } | ||||||||||||||||||||||||||||||||
| 577 | |||||||||||||||||||||||||||||||||
| 578 | # @values = $target->m_get_values() | ||||||||||||||||||||||||||||||||
| 579 | 0 | ▶ | sub m_get_values { | ||||||||||||||||||||||||||||||
|
Subroutine
m_get_values: not called CC=1 SCAR=6.9
| |||||||||||||||||||||||||||||||||
| 580 | 0 | my $target = shift; | |||||||||||||||||||||||||||||||
| 581 | 0 | map { $target->m_get_value_for_key($_) } $target->m_get_keys; | |||||||||||||||||||||||||||||||
| 582 | } | ||||||||||||||||||||||||||||||||
| 583 | |||||||||||||||||||||||||||||||||
| 584 | # $value = $target->m_get_value_for_key($key); | ||||||||||||||||||||||||||||||||
| 585 | 0 | ▶ | sub m_get_value_for_key { | ||||||||||||||||||||||||||||||
|
Subroutine
m_get_value_for_key: not called CC=2 SCAR=17.9
| |||||||||||||||||||||||||||||||||
| 586 | 0 | my ($target, $key) = @_; | |||||||||||||||||||||||||||||||
| 587 | 0 | ▶ | return $target->$key() if ( $target->can($key) ); | ||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||
| 588 | 0 | die "$target is unable to get value for key '$key'\n"; | |||||||||||||||||||||||||||||||
| 589 | } | ||||||||||||||||||||||||||||||||
| 590 | |||||||||||||||||||||||||||||||||
| 591 | # $target->m_set_value_for_key($key, $value); | ||||||||||||||||||||||||||||||||
| 592 | 0 | ▶ | sub m_set_value_for_key { | ||||||||||||||||||||||||||||||
|
Subroutine
m_set_value_for_key: not called CC=2 SCAR=17.9
| |||||||||||||||||||||||||||||||||
| 593 | 0 | my ($target, $key, $value) = @_; | |||||||||||||||||||||||||||||||
| 594 | 0 | ▶ | return $target->$key($value) if ( $target->can($key) ); | ||||||||||||||||||||||||||||||
|
Branch: 1 branch
| |||||||||||||||||||||||||||||||||
| 595 | 0 | die "$target is unable to set value for key '$key'\n"; | |||||||||||||||||||||||||||||||
| 596 | } | ||||||||||||||||||||||||||||||||
| 597 | |||||||||||||||||||||||||||||||||
| 598 | # No default implementation provided for these other supported methods... | ||||||||||||||||||||||||||||||||
| 599 | # $value_reference = $target->m_get_reference_for_key($key); | ||||||||||||||||||||||||||||||||
| 600 | # $value = $target->m_get_or_create_value_for_key($key); | ||||||||||||||||||||||||||||||||
| 601 | # $value = $target->m_get_value_for_keys(@keys); | ||||||||||||||||||||||||||||||||
| 602 | # $target->m_set_value_for_keys($value, @keys); | ||||||||||||||||||||||||||||||||
| 603 | # $val_ref = $target->m_get_reference_for_keys(@keys); | ||||||||||||||||||||||||||||||||
| 604 | # $target->m_set_value_for_keys($value, @keys); | ||||||||||||||||||||||||||||||||
| 605 | |||||||||||||||||||||||||||||||||
| 606 | 2 | 1; | |||||||||||||||||||||||||||||||
| 607 | |||||||||||||||||||||||||||||||||
| 608 | __END__ | ||||||||||||||||||||||||||||||||