| Filename | /usr/local/lib/perl5/5.36/constant.pm |
| Statements | Executed 187 statements in 1.70ms |
| Calls | P | F | Exclusive Time |
Inclusive Time |
Subroutine |
|---|---|---|---|---|---|
| 5 | 5 | 1 | 213µs | 266µs | constant::import |
| 1 | 1 | 1 | 20µs | 22µs | constant::BEGIN@24 |
| 1 | 1 | 1 | 18µs | 18µs | constant::BEGIN@2 |
| 5 | 1 | 1 | 14µs | 14µs | constant::CORE:subst (opcode) |
| 5 | 1 | 1 | 14µs | 14µs | constant::CORE:match (opcode) |
| 5 | 1 | 1 | 12µs | 12µs | constant::CORE:regcomp (opcode) |
| 1 | 1 | 1 | 10µs | 16µs | constant::BEGIN@40 |
| 1 | 1 | 1 | 8µs | 13µs | constant::BEGIN@141 |
| 1 | 1 | 1 | 8µs | 13µs | constant::BEGIN@90 |
| 3 | 3 | 1 | 8µs | 8µs | constant::CORE:qr (opcode) |
| 1 | 1 | 1 | 7µs | 10µs | constant::BEGIN@3 |
| 1 | 1 | 1 | 7µs | 12µs | constant::BEGIN@65 |
| 1 | 1 | 1 | 7µs | 27µs | constant::BEGIN@4 |
| 0 | 0 | 0 | 0s | 0s | constant::__ANON__[:174] |
| 0 | 0 | 0 | 0s | 0s | constant::__ANON__[:190] |
| 0 | 0 | 0 | 0s | 0s | constant::__ANON__[:192] |
| 0 | 0 | 0 | 0s | 0s | constant::__ANON__[:41] |
| 0 | 0 | 0 | 0s | 0s | constant::__ANON__[:42] |
| 0 | 0 | 0 | 0s | 0s | constant::__ANON__[:43] |
| Line | State ments |
Time on line |
Calls | Time in subs |
Code |
|---|---|---|---|---|---|
| 1 | package constant; | ||||
| 2 | 2 | 50µs | 1 | 18µs | # spent 18µs within constant::BEGIN@2 which was called:
# once (18µs+0s) by File::Spec::Unix::BEGIN@115 at line 2 # spent 18µs making 1 call to constant::BEGIN@2 |
| 3 | 2 | 24µs | 2 | 13µs | # spent 10µs (7+3) within constant::BEGIN@3 which was called:
# once (7µs+3µs) by File::Spec::Unix::BEGIN@115 at line 3 # spent 10µs making 1 call to constant::BEGIN@3
# spent 3µs making 1 call to strict::import |
| 4 | 2 | 391µs | 2 | 48µs | # spent 27µs (7+21) within constant::BEGIN@4 which was called:
# once (7µs+21µs) by File::Spec::Unix::BEGIN@115 at line 4 # spent 27µs making 1 call to constant::BEGIN@4
# spent 21µs making 1 call to warnings::register::import |
| 5 | |||||
| 6 | 1 | 800ns | our $VERSION = '1.33'; | ||
| 7 | our %declared; | ||||
| 8 | |||||
| 9 | #======================================================================= | ||||
| 10 | |||||
| 11 | # Some names are evil choices. | ||||
| 12 | 1 | 5µs | my %keywords = map +($_, 1), qw{ BEGIN INIT CHECK END DESTROY AUTOLOAD }; | ||
| 13 | 1 | 2µs | $keywords{UNITCHECK}++ if $] > 5.009; | ||
| 14 | |||||
| 15 | 1 | 4µs | my %forced_into_main = map +($_, 1), | ||
| 16 | qw{ STDIN STDOUT STDERR ARGV ARGVOUT ENV INC SIG }; | ||||
| 17 | |||||
| 18 | 1 | 4µs | my %forbidden = (%keywords, %forced_into_main); | ||
| 19 | |||||
| 20 | 1 | 12µs | 1 | 6µs | my $normal_constant_name = qr/^_?[^\W_0-9]\w*\z/; # spent 6µs making 1 call to constant::CORE:qr |
| 21 | 1 | 3µs | 1 | 1µs | my $tolerable = qr/^[A-Za-z_]\w*\z/; # spent 1µs making 1 call to constant::CORE:qr |
| 22 | 1 | 3µs | 1 | 800ns | my $boolean = qr/^[01]?\z/; # spent 800ns making 1 call to constant::CORE:qr |
| 23 | |||||
| 24 | # spent 22µs (20+2) within constant::BEGIN@24 which was called:
# once (20µs+2µs) by File::Spec::Unix::BEGIN@115 at line 45 | ||||
| 25 | # We'd like to do use constant _CAN_PCS => $] > 5.009002 | ||||
| 26 | # but that's a bit tricky before we load the constant module :-) | ||||
| 27 | # By doing this, we save several run time checks for *every* call | ||||
| 28 | # to import. | ||||
| 29 | 1 | 900ns | my $const = $] > 5.009002; | ||
| 30 | 1 | 500ns | my $downgrade = $] < 5.015004; # && $] >= 5.008 | ||
| 31 | 1 | 700ns | my $constarray = exists &_make_const; | ||
| 32 | 1 | 7µs | if ($const) { | ||
| 33 | 1 | 11µs | 1 | 1µs | Internals::SvREADONLY($const, 1); # spent 1µs making 1 call to Internals::SvREADONLY |
| 34 | 1 | 3µs | 1 | 500ns | Internals::SvREADONLY($downgrade, 1); # spent 500ns making 1 call to Internals::SvREADONLY |
| 35 | 1 | 1µs | $constant::{_CAN_PCS} = \$const; | ||
| 36 | 1 | 600ns | $constant::{_DOWNGRADE} = \$downgrade; | ||
| 37 | 1 | 800ns | $constant::{_CAN_PCS_FOR_ARRAY} = \$constarray; | ||
| 38 | } | ||||
| 39 | else { | ||||
| 40 | 2 | 97µs | 2 | 22µs | # spent 16µs (10+6) within constant::BEGIN@40 which was called:
# once (10µs+6µs) by File::Spec::Unix::BEGIN@115 at line 40 # spent 16µs making 1 call to constant::BEGIN@40
# spent 6µs making 1 call to strict::unimport |
| 41 | *{"_CAN_PCS"} = sub () {$const}; | ||||
| 42 | *{"_DOWNGRADE"} = sub () { $downgrade }; | ||||
| 43 | *{"_CAN_PCS_FOR_ARRAY"} = sub () { $constarray }; | ||||
| 44 | } | ||||
| 45 | 1 | 61µs | 1 | 22µs | } # spent 22µs making 1 call to constant::BEGIN@24 |
| 46 | |||||
| 47 | #======================================================================= | ||||
| 48 | # import() - import symbols into user's namespace | ||||
| 49 | # | ||||
| 50 | # What we actually do is define a function in the caller's namespace | ||||
| 51 | # which returns the value. The function we create will normally | ||||
| 52 | # be inlined as a constant, thereby avoiding further sub calling | ||||
| 53 | # overhead. | ||||
| 54 | #======================================================================= | ||||
| 55 | # spent 266µs (213+53) within constant::import which was called 5 times, avg 53µs/call:
# once (55µs+12µs) by File::Spec::Unix::BEGIN@231 at line 231 of File/Spec/Unix.pm
# once (48µs+11µs) by File::Spec::Unix::BEGIN@209 at line 209 of File/Spec/Unix.pm
# once (39µs+15µs) by File::Spec::Unix::BEGIN@115 at line 115 of File/Spec/Unix.pm
# once (43µs+8µs) by File::Spec::Unix::BEGIN@124 at line 124 of File/Spec/Unix.pm
# once (28µs+7µs) by File::Spec::Unix::BEGIN@133 at line 133 of File/Spec/Unix.pm | ||||
| 56 | 5 | 4µs | my $class = shift; | ||
| 57 | 5 | 2µs | return unless @_; # Ignore 'use constant;' | ||
| 58 | 5 | 1µs | my $constants; | ||
| 59 | 5 | 3µs | my $multiple = ref $_[0]; | ||
| 60 | 5 | 4µs | my $caller = caller; | ||
| 61 | 5 | 2µs | my $flush_mro; | ||
| 62 | my $symtab; | ||||
| 63 | |||||
| 64 | 5 | 4µs | if (_CAN_PCS) { | ||
| 65 | 2 | 136µs | 2 | 17µs | # spent 12µs (7+5) within constant::BEGIN@65 which was called:
# once (7µs+5µs) by File::Spec::Unix::BEGIN@115 at line 65 # spent 12µs making 1 call to constant::BEGIN@65
# spent 5µs making 1 call to strict::unimport |
| 66 | 10 | 13µs | $symtab = \%{$caller . '::'}; | ||
| 67 | }; | ||||
| 68 | |||||
| 69 | 5 | 3µs | if ( $multiple ) { | ||
| 70 | if (ref $_[0] ne 'HASH') { | ||||
| 71 | require Carp; | ||||
| 72 | Carp::croak("Invalid reference type '".ref(shift)."' not 'HASH'"); | ||||
| 73 | } | ||||
| 74 | $constants = shift; | ||||
| 75 | } else { | ||||
| 76 | 5 | 2µs | unless (defined $_[0]) { | ||
| 77 | require Carp; | ||||
| 78 | Carp::croak("Can't use undef as constant name"); | ||||
| 79 | } | ||||
| 80 | 5 | 7µs | $constants->{+shift} = undef; | ||
| 81 | } | ||||
| 82 | |||||
| 83 | 5 | 8µs | foreach my $name ( keys %$constants ) { | ||
| 84 | 5 | 1µs | my $pkg; | ||
| 85 | 5 | 2µs | my $symtab = $symtab; | ||
| 86 | 5 | 2µs | my $orig_name = $name; | ||
| 87 | 5 | 30µs | 5 | 14µs | if ($name =~ s/(.*)(?:::|')(?=.)//s) { # spent 14µs making 5 calls to constant::CORE:subst, avg 3µs/call |
| 88 | $pkg = $1; | ||||
| 89 | if (_CAN_PCS && $pkg ne $caller) { | ||||
| 90 | 2 | 232µs | 2 | 18µs | # spent 13µs (8+5) within constant::BEGIN@90 which was called:
# once (8µs+5µs) by File::Spec::Unix::BEGIN@115 at line 90 # spent 13µs making 1 call to constant::BEGIN@90
# spent 5µs making 1 call to strict::unimport |
| 91 | $symtab = \%{$pkg . '::'}; | ||||
| 92 | } | ||||
| 93 | } | ||||
| 94 | else { | ||||
| 95 | 5 | 2µs | $pkg = $caller; | ||
| 96 | } | ||||
| 97 | |||||
| 98 | # Normal constant name | ||||
| 99 | 5 | 50µs | 10 | 25µs | if ($name =~ $normal_constant_name and !$forbidden{$name}) { # spent 14µs making 5 calls to constant::CORE:match, avg 3µs/call
# spent 12µs making 5 calls to constant::CORE:regcomp, avg 2µs/call |
| 100 | # Everything is okay | ||||
| 101 | |||||
| 102 | # Name forced into main, but we're not in main. Fatal. | ||||
| 103 | } elsif ($forced_into_main{$name} and $pkg ne 'main') { | ||||
| 104 | require Carp; | ||||
| 105 | Carp::croak("Constant name '$name' is forced into main::"); | ||||
| 106 | |||||
| 107 | # Starts with double underscore. Fatal. | ||||
| 108 | } elsif ($name =~ /^__/) { | ||||
| 109 | require Carp; | ||||
| 110 | Carp::croak("Constant name '$name' begins with '__'"); | ||||
| 111 | |||||
| 112 | # Maybe the name is tolerable | ||||
| 113 | } elsif ($name =~ $tolerable) { | ||||
| 114 | # Then we'll warn only if you've asked for warnings | ||||
| 115 | if (warnings::enabled()) { | ||||
| 116 | if ($keywords{$name}) { | ||||
| 117 | warnings::warn("Constant name '$name' is a Perl keyword"); | ||||
| 118 | } elsif ($forced_into_main{$name}) { | ||||
| 119 | warnings::warn("Constant name '$name' is " . | ||||
| 120 | "forced into package main::"); | ||||
| 121 | } | ||||
| 122 | } | ||||
| 123 | |||||
| 124 | # Looks like a boolean | ||||
| 125 | # use constant FRED == fred; | ||||
| 126 | } elsif ($name =~ $boolean) { | ||||
| 127 | require Carp; | ||||
| 128 | if (@_) { | ||||
| 129 | Carp::croak("Constant name '$name' is invalid"); | ||||
| 130 | } else { | ||||
| 131 | Carp::croak("Constant name looks like boolean value"); | ||||
| 132 | } | ||||
| 133 | |||||
| 134 | } else { | ||||
| 135 | # Must have bad characters | ||||
| 136 | require Carp; | ||||
| 137 | Carp::croak("Constant name '$name' has invalid characters"); | ||||
| 138 | } | ||||
| 139 | |||||
| 140 | { | ||||
| 141 | 7 | 375µs | 2 | 18µs | # spent 13µs (8+5) within constant::BEGIN@141 which was called:
# once (8µs+5µs) by File::Spec::Unix::BEGIN@115 at line 141 # spent 13µs making 1 call to constant::BEGIN@141
# spent 5µs making 1 call to strict::unimport |
| 142 | 5 | 3µs | my $full_name = "${pkg}::$name"; | ||
| 143 | 5 | 5µs | $declared{$full_name}++; | ||
| 144 | 5 | 6µs | if ($multiple || @_ == 1) { | ||
| 145 | 5 | 3µs | my $scalar = $multiple ? $constants->{$orig_name} : $_[0]; | ||
| 146 | |||||
| 147 | if (_DOWNGRADE) { # for 5.8 to 5.14 | ||||
| 148 | # Work around perl bug #31991: Sub names (actually glob | ||||
| 149 | # names in general) ignore the UTF8 flag. So we have to | ||||
| 150 | # turn it off to get the "right" symbol table entry. | ||||
| 151 | utf8::is_utf8 $name and utf8::encode $name; | ||||
| 152 | } | ||||
| 153 | |||||
| 154 | # The constant serves to optimise this entire block out on | ||||
| 155 | # 5.8 and earlier. | ||||
| 156 | 5 | 4µs | if (_CAN_PCS) { | ||
| 157 | # Use a reference as a proxy for a constant subroutine. | ||||
| 158 | # If this is not a glob yet, it saves space. If it is | ||||
| 159 | # a glob, we must still create it this way to get the | ||||
| 160 | # right internal flags set, as constants are distinct | ||||
| 161 | # from subroutines created with sub(){...}. | ||||
| 162 | # The check in Perl_ck_rvconst knows that inlinable | ||||
| 163 | # constants from cv_const_sv are read only. So we have to: | ||||
| 164 | 5 | 23µs | 5 | 6µs | Internals::SvREADONLY($scalar, 1); # spent 6µs making 5 calls to Internals::SvREADONLY, avg 1µs/call |
| 165 | 5 | 7µs | if (!exists $symtab->{$name}) { | ||
| 166 | 5 | 5µs | $symtab->{$name} = \$scalar; | ||
| 167 | 5 | 12µs | ++$flush_mro->{$pkg}; | ||
| 168 | } | ||||
| 169 | else { | ||||
| 170 | local $constant::{_dummy} = \$scalar; | ||||
| 171 | *$full_name = \&{"_dummy"}; | ||||
| 172 | } | ||||
| 173 | } else { | ||||
| 174 | *$full_name = sub () { $scalar }; | ||||
| 175 | } | ||||
| 176 | } elsif (@_) { | ||||
| 177 | my @list = @_; | ||||
| 178 | if (_CAN_PCS_FOR_ARRAY) { | ||||
| 179 | _make_const($list[$_]) for 0..$#list; | ||||
| 180 | _make_const(@list); | ||||
| 181 | if (!exists $symtab->{$name}) { | ||||
| 182 | $symtab->{$name} = \@list; | ||||
| 183 | $flush_mro->{$pkg}++; | ||||
| 184 | } | ||||
| 185 | else { | ||||
| 186 | local $constant::{_dummy} = \@list; | ||||
| 187 | *$full_name = \&{"_dummy"}; | ||||
| 188 | } | ||||
| 189 | } | ||||
| 190 | else { *$full_name = sub () { @list }; } | ||||
| 191 | } else { | ||||
| 192 | *$full_name = sub () { }; | ||||
| 193 | } | ||||
| 194 | } | ||||
| 195 | } | ||||
| 196 | # Flush the cache exactly once if we make any direct symbol table changes. | ||||
| 197 | 5 | 28µs | if (_CAN_PCS && $flush_mro) { | ||
| 198 | 5 | 32µs | 5 | 8µs | mro::method_changed_in($_) for keys %$flush_mro; # spent 8µs making 5 calls to mro::method_changed_in, avg 2µs/call |
| 199 | } | ||||
| 200 | } | ||||
| 201 | |||||
| 202 | 1 | 8µs | 1; | ||
| 203 | |||||
| 204 | __END__ | ||||
# spent 14µs within constant::CORE:match which was called 5 times, avg 3µs/call:
# 5 times (14µs+0s) by constant::import at line 99, avg 3µs/call | |||||
sub constant::CORE:qr; # opcode | |||||
# spent 12µs within constant::CORE:regcomp which was called 5 times, avg 2µs/call:
# 5 times (12µs+0s) by constant::import at line 99, avg 2µs/call | |||||
# spent 14µs within constant::CORE:subst which was called 5 times, avg 3µs/call:
# 5 times (14µs+0s) by constant::import at line 87, avg 3µs/call |