The Perl and Raku Conference 2025: Greenville, South Carolina - June 27-29 Learn more

#!perl -w
use strict;
use utf8;
BEGIN {use_ok('XS::APItest')};
sub preform_test;
sub test_present;
sub test_absent;
sub test_delete_present;
sub test_delete_absent;
sub brute_force_exists;
sub test_store;
sub test_fetch_present;
sub test_fetch_absent;
my $utf8_for_258 = chr 258;
utf8::encode $utf8_for_258;
my @testkeys = ('N', chr utf8::unicode_to_native(198), chr 256);
my @keys = (@testkeys, $utf8_for_258);
foreach (@keys) {
utf8::downgrade $_, 1;
}
main_tests (\@keys, \@testkeys, '');
foreach (@keys) {
utf8::upgrade $_;
}
main_tests (\@keys, \@testkeys, ' [utf8 hash]');
{
my %h = (a=>'cheat');
tie %h, 'Tie::StdHash';
# is bug 36327 fixed?
my $result = ($] > 5.009) ? undef : 1;
is (XS::APItest::Hash::store(\%h, chr 258, 1), $result);
ok (!exists $h{$utf8_for_258},
"hv_store doesn't insert a key with the raw utf8 on a tied hash");
}
{
my $strtab = strtab();
is (ref $strtab, 'HASH', "The shared string table quacks like a hash");
my $wibble = "\0";
eval {
$strtab->{$wibble}++;
};
my $prefix = "Cannot modify shared string table in hv_";
my $what = $prefix . 'fetch';
like ($@, qr/^$what/,$what);
eval {
XS::APItest::Hash::store($strtab, 'Boom!', 1)
};
$what = $prefix . 'store';
like ($@, qr/^$what/, $what);
if (0) {
A::B->method();
}
# DESTROY should be in there.
eval {
delete $strtab->{DESTROY};
};
$what = $prefix . 'delete';
like ($@, qr/^$what/, $what);
# I can't work out how to get to the code that flips the wasutf8 flag on
# the hash key without some ikcy XS
}
{
is_deeply([&XS::APItest::Hash::test_hv_free_ent], [2,2,1,1],
"hv_free_ent frees the value immediately");
is_deeply([&XS::APItest::Hash::test_hv_delayfree_ent], [2,2,2,1],
"hv_delayfree_ent keeps the value around until FREETMPS");
}
foreach my $in ("", "N", "a\0b") {
my $got = XS::APItest::Hash::test_share_unshare_pvn($in);
is ($got, $in, "test_share_unshare_pvn");
}
{
foreach ([\&XS::APItest::Hash::rot13_hash, \&rot13, "rot 13"],
[\&XS::APItest::Hash::bitflip_hash, \&bitflip, "bitflip"],
) {
my ($setup, $mapping, $name) = @$_;
my %hash;
my %placebo = (a => 1, p => 2, i => 4, e => 8);
$setup->(\%hash);
$hash{a}++; @hash{qw(p i e)} = (2, 4, 8);
test_U_hash(\%hash, \%placebo, [f => 9, g => 10, h => 11], $mapping,
$name);
}
foreach my $upgrade_o (0, 1) {
foreach my $upgrade_n (0, 1) {
my (%hash, %placebo);
XS::APItest::Hash::bitflip_hash(\%hash);
foreach my $new (["7", utf8::unicode_to_native(65),
utf8::unicode_to_native(67),
utf8::unicode_to_native(80)
],
["8", utf8::unicode_to_native(163),
utf8::unicode_to_native(171),
utf8::unicode_to_native(215)
],
["U", 2603, 2604, 2604],
) {
foreach my $code (utf8::unicode_to_native(78),
utf8::unicode_to_native(240),
256,
1336
) {
my $key = chr $code;
# This is the UTF-8 byte sequence for the key.
my $key_utf8 = $key;
utf8::encode($key_utf8);
if ($upgrade_o) {
$key .= chr 256;
chop $key;
}
$hash{$key} = $placebo{$key} = $code;
$hash{$key_utf8} = $placebo{$key_utf8} = "$code as UTF-8";
}
my $name = 'bitflip ' . shift @$new;
my @new_kv;
foreach my $code (@$new) {
my $key = chr $code;
if ($upgrade_n) {
$key .= chr 256;
chop $key;
}
push @new_kv, $key, $_;
}
$name .= ' upgraded(orig) ' if $upgrade_o;
$name .= ' upgraded(new) ' if $upgrade_n;
test_U_hash(\%hash, \%placebo, \@new_kv, \&bitflip, $name);
}
}
}
}
sub test_precomputed_hashes {
my $what = shift;
my $hash_it = shift;
my $ord = shift;
my $key_copy = $_[0];
$key_copy .= '';
my %hash;
is (XS::APItest::Hash::common({hv => \%hash,
"key$what" => $_[0],
val => $ord,
"hash_$what" => $hash_it,
action => XS::APItest::HV_FETCH_ISSTORE}),
$ord, "store $ord with $what \$hash_it = $hash_it");
is_deeply ([each %hash], [$_[0], $ord], "First key read is good");
is_deeply ([each %hash], [], "No second key good");
is ($hash{$_[0]}, $ord, "Direct hash read finds $ord");
is_deeply ([each %hash], [$key_copy, $ord],
"First key read is good with a copy");
is_deeply ([each %hash], [], "No second key good");
is ($hash{$key_copy}, $ord, "Direct hash read finds $ord");
}
{
my $as_utf8 = "\241" . chr 256;
chop $as_utf8;
my $as_bytes = "\243";
foreach my $key ('N', $as_bytes, $as_utf8, "\x{2623}") {
my $ord = ord $key;
foreach my $hash_it (0, 1) {
foreach my $what (qw(pv sv)) {
test_precomputed_hashes($what, $hash_it, $ord, $key);
}
# Generate a shared hash key scalar
my %h = ($key => 1);
test_precomputed_hashes('sv', $hash_it, $ord, (keys %h)[0]);
}
}
}
{
no warnings 'experimental::builtin';
use builtin 'weaken';
my %h;
fill_hash_with_nulls(\%h);
my @objs;
for("a".."z","A".."Z") {
weaken($objs[@objs] = $h{$_} = []);
}
undef %h;
no warnings 'uninitialized';
local $" = "";
is "@objs", "",
'explicitly undeffing a hash with nulls frees all entries';
my $h = {};
fill_hash_with_nulls($h);
@objs = ();
for("a".."z","A".."Z") {
weaken($objs[@objs] = $$h{$_} = []);
}
undef $h;
is "@objs", "", 'freeing a hash with nulls frees all entries';
}
# Tests for HvENAME and UTF8
{
no strict;
no warnings 'void';
my $hvref;
*{"\xff::bar"}; # autovivify %ÿ:: without UTF8
*{"\xff::bαr::"} = $hvref = \%foo::;
undef *foo::;
is HvENAME($hvref), "\xff::bαr",
'stash alias (utf8 inside bytes) does not create malformed UTF8';
*{"é::foo"}; # autovivify %é:: with UTF8
*{"\xe9::\xe9::"} = $hvref = \%bar::;
undef *bar::;
is HvENAME($hvref), "\xe9::\xe9",
'stash alias (bytes inside utf8) does not create malformed UTF8';
*{"\xfe::bar"}; *{"\xfd::bar"};
*{"\xfe::bαr::"} = \%goo::;
*{"\xfd::bαr::"} = $hvref = \%goo::;
undef *goo::;
like HvENAME($hvref), qr/^[\xfe\xfd]::bαr\z/,
'multiple stash aliases (utf8 inside bytes) do not cause bad UTF8';
*{"è::foo"}; *{"ë::foo"};
*{"\xe8::\xe9::"} = $hvref = \%bear::;
*{"\xeb::\xe9::"} = \%bear::;
undef *bear::;
like HvENAME($hvref), qr"^[\xe8\xeb]::\xe9\z",
'multiple stash aliases (bytes inside utf8) do not cause bad UTF8';
}
{ # newHVhv
use Tie::Hash;
tie my %h, 'Tie::StdHash';
%h = 1..10;
is join(' ', sort %{newHVhv \%h}), '1 10 2 3 4 5 6 7 8 9',
'newHVhv on tied hash';
}
# helem and hslice on entry with null value
# This is actually a test for a Perl operator, not an XS API test. But it
# requires a hash that can only be produced by XS (although recently it
# could be encountered when tying hint hashes).
{
my %h;
fill_hash_with_nulls(\%h);
eval{ $h{84} = 1 };
pass 'no crash when writing to hash elem with null value';
eval{ no # silly
warnings; # thank you!
@h{85} = 1 };
pass 'no crash when writing to hash elem with null value via slice';
eval { delete local $h{86} };
pass 'no crash during local deletion of hash elem with null value';
eval { delete local @h{87,88} };
pass 'no crash during local deletion of hash slice with null values';
}
# [perl #111000] Bug number eleventy-one thousand:
# hv_store should work on hint hashes
eval q{
BEGIN {
XS::APItest::Hash::store \%^H, "XS::APItest/hash.t", undef;
delete $^H{"XS::APItest/hash.t"};
}
};
pass("hv_store works on the hint hash");
{
# [perl #79074] HeSVKEY_force loses UTF8ness
my %hash = ( "\xff" => 1, "\x{100}" => 1 );
my @keys = sort ( XS::APItest::Hash::test_force_keys(\%hash) );
is_deeply(\@keys, [ sort keys %hash ], "check HeSVKEY_force()");
}
# Test that mg_copy is called when expected (and not called when not)
# No (other) tests in core will fail if the implementation of `keys %tied_hash`
# is (accidentally) changed to also call hv_iterval() and trigger mg_copy.
# However, this behaviour is visible, and tested by Variable::Magic on CPAN.
{
my %h;
my $obj = tie %h, 'Tie::StdHash';
sv_magic_mycopy(\%h);
is(sv_magic_mycopy_count(\%h), 0);
$h{perl} = "rules";
is(sv_magic_mycopy_count(\%h), 1);
is($h{perl}, "rules", "found key");
is(sv_magic_mycopy_count(\%h), 2);
# keys *doesn't* trigger copy magic, so the count is still 2
my @flat = keys %h;
is(sv_magic_mycopy_count(\%h), 2);
@flat = values %h;
is(sv_magic_mycopy_count(\%h), 3);
@flat = each %h;
is(sv_magic_mycopy_count(\%h), 4);
}
{
# There are two API variants - hv_delete and hv_delete_ent. The Perl
# interpreter exclusively uses hv_delete_ent. Only XS code uses hv_delete.
# Hence the problem case could only be triggered by XS code called on
# symbol tables, and with particular non-ASCII keys:
# Deleting a key with WASUTF from a stash used to trigger a use-after free:
my $key = "\xFF\x{100}";
chop $key;
++$main::{$key};
is(XS::APItest::Hash::delete(\%main::, $key), 1,
"hv_delete doesn't trigger a use-after free");
# Perl code has always used this API, which never had the problem:
++$main::{$key};
is(XS::APItest::Hash::delete_ent(\%main::, $key), 1,
"hv_delete_ent never triggered a use-after free, but test it anyway");
}
done_testing;
exit;
################################ The End ################################
sub test_U_hash {
my ($hash, $placebo, $new, $mapping, $message) = @_;
my @hitlist = keys %$placebo;
print "# $message\n";
my @keys = sort keys %$hash;
is ("@keys", join(' ', sort($mapping->(keys %$placebo))),
"uvar magic called exactly once on store");
is (keys %$hash, keys %$placebo);
my $victim = shift @hitlist;
is (delete $hash->{$victim}, delete $placebo->{$victim});
is (keys %$hash, keys %$placebo);
@keys = sort keys %$hash;
is ("@keys", join(' ', sort($mapping->(keys %$placebo))));
$victim = shift @hitlist;
is (XS::APItest::Hash::delete_ent ($hash, $victim,
XS::APItest::HV_DISABLE_UVAR_XKEY),
undef, "Deleting a known key with conversion disabled fails (ent)");
is (keys %$hash, keys %$placebo);
is (XS::APItest::Hash::delete_ent ($hash, $victim, 0),
delete $placebo->{$victim},
"Deleting a known key with conversion enabled works (ent)");
is (keys %$hash, keys %$placebo);
@keys = sort keys %$hash;
is ("@keys", join(' ', sort($mapping->(keys %$placebo))));
$victim = shift @hitlist;
is (XS::APItest::Hash::delete ($hash, $victim,
XS::APItest::HV_DISABLE_UVAR_XKEY),
undef, "Deleting a known key with conversion disabled fails");
is (keys %$hash, keys %$placebo);
is (XS::APItest::Hash::delete ($hash, $victim, 0),
delete $placebo->{$victim},
"Deleting a known key with conversion enabled works");
is (keys %$hash, keys %$placebo);
@keys = sort keys %$hash;
is ("@keys", join(' ', sort($mapping->(keys %$placebo))));
my ($k, $v) = splice @$new, 0, 2;
$hash->{$k} = $v;
$placebo->{$k} = $v;
is (keys %$hash, keys %$placebo);
@keys = sort keys %$hash;
is ("@keys", join(' ', sort($mapping->(keys %$placebo))));
($k, $v) = splice @$new, 0, 2;
is (XS::APItest::Hash::store_ent($hash, $k, $v), $v, "store_ent");
$placebo->{$k} = $v;
is (keys %$hash, keys %$placebo);
@keys = sort keys %$hash;
is ("@keys", join(' ', sort($mapping->(keys %$placebo))));
($k, $v) = splice @$new, 0, 2;
is (XS::APItest::Hash::store($hash, $k, $v), $v, "store");
$placebo->{$k} = $v;
is (keys %$hash, keys %$placebo);
@keys = sort keys %$hash;
is ("@keys", join(' ', sort($mapping->(keys %$placebo))));
@hitlist = keys %$placebo;
$victim = shift @hitlist;
is (XS::APItest::Hash::fetch_ent($hash, $victim), $placebo->{$victim},
"fetch_ent");
is (XS::APItest::Hash::fetch_ent($hash, $mapping->($victim)), undef,
"fetch_ent (missing)");
$victim = shift @hitlist;
is (XS::APItest::Hash::fetch($hash, $victim), $placebo->{$victim},
"fetch");
is (XS::APItest::Hash::fetch($hash, $mapping->($victim)), undef,
"fetch (missing)");
$victim = shift @hitlist;
ok (XS::APItest::Hash::exists_ent($hash, $victim), "exists_ent");
ok (!XS::APItest::Hash::exists_ent($hash, $mapping->($victim)),
"exists_ent (missing)");
$victim = shift @hitlist;
die "Need a victim" unless defined $victim;
ok (XS::APItest::Hash::exists($hash, $victim), "exists");
ok (!XS::APItest::Hash::exists($hash, $mapping->($victim)),
"exists (missing)");
is (XS::APItest::Hash::common({hv => $hash, keysv => $victim}),
$placebo->{$victim}, "common (fetch)");
is (XS::APItest::Hash::common({hv => $hash, keypv => $victim}),
$placebo->{$victim}, "common (fetch pv)");
is (XS::APItest::Hash::common({hv => $hash, keysv => $victim,
action => XS::APItest::HV_DISABLE_UVAR_XKEY}),
undef, "common (fetch) missing");
is (XS::APItest::Hash::common({hv => $hash, keypv => $victim,
action => XS::APItest::HV_DISABLE_UVAR_XKEY}),
undef, "common (fetch pv) missing");
is (XS::APItest::Hash::common({hv => $hash, keysv => $mapping->($victim),
action => XS::APItest::HV_DISABLE_UVAR_XKEY}),
$placebo->{$victim}, "common (fetch) missing mapped");
is (XS::APItest::Hash::common({hv => $hash, keypv => $mapping->($victim),
action => XS::APItest::HV_DISABLE_UVAR_XKEY}),
$placebo->{$victim}, "common (fetch pv) missing mapped");
}
sub main_tests {
my ($keys, $testkeys, $description) = @_;
foreach my $key (@$testkeys) {
my $lckey = ($key eq chr utf8::unicode_to_native(198)) ? chr utf8::unicode_to_native(230) : lc $key;
my $unikey = $key;
utf8::encode $unikey;
utf8::downgrade $key, 1;
utf8::downgrade $lckey, 1;
utf8::downgrade $unikey, 1;
main_test_inner ($key, $lckey, $unikey, $keys, $description);
utf8::upgrade $key;
utf8::upgrade $lckey;
utf8::upgrade $unikey;
main_test_inner ($key, $lckey, $unikey, $keys,
$description . ' [key utf8 on]');
}
# hv_exists was buggy for tied hashes, in that the raw utf8 key was being
# used - the utf8 flag was being lost.
perform_test (\&test_absent, (chr 258), $keys, '');
perform_test (\&test_fetch_absent, (chr 258), $keys, '');
perform_test (\&test_delete_absent, (chr 258), $keys, '');
}
sub main_test_inner {
my ($key, $lckey, $unikey, $keys, $description) = @_;
perform_test (\&test_present, $key, $keys, $description);
perform_test (\&test_fetch_present, $key, $keys, $description);
perform_test (\&test_delete_present, $key, $keys, $description);
perform_test (\&test_store, $key, $keys, $description, [a=>'cheat']);
perform_test (\&test_store, $key, $keys, $description, []);
perform_test (\&test_absent, $lckey, $keys, $description);
perform_test (\&test_fetch_absent, $lckey, $keys, $description);
perform_test (\&test_delete_absent, $lckey, $keys, $description);
return if $unikey eq $key;
perform_test (\&test_absent, $unikey, $keys, $description);
perform_test (\&test_fetch_absent, $unikey, $keys, $description);
perform_test (\&test_delete_absent, $unikey, $keys, $description);
}
sub perform_test {
my ($test_sub, $key, $keys, $message, @other) = @_;
my $printable = join ',', map {ord} split //, $key;
my (%hash, %tiehash);
tie %tiehash, 'Tie::StdHash';
@hash{@$keys} = @$keys;
@tiehash{@$keys} = @$keys;
&$test_sub (\%hash, $key, $printable, $message, @other);
&$test_sub (\%tiehash, $key, $printable, "$message tie", @other);
}
sub test_present {
my ($hash, $key, $printable, $message) = @_;
ok (exists $hash->{$key}, "hv_exists_ent present$message $printable");
ok (XS::APItest::Hash::exists ($hash, $key),
"hv_exists present$message $printable");
}
sub test_absent {
my ($hash, $key, $printable, $message) = @_;
ok (!exists $hash->{$key}, "hv_exists_ent absent$message $printable");
ok (!XS::APItest::Hash::exists ($hash, $key),
"hv_exists absent$message $printable");
}
sub test_delete_present {
my ($hash, $key, $printable, $message) = @_;
my $copy = {};
my $class = tied %$hash;
if (defined $class) {
tie %$copy, ref $class;
}
$copy = {%$hash};
ok (brute_force_exists ($copy, $key),
"hv_delete_ent present$message $printable");
is (delete $copy->{$key}, $key, "hv_delete_ent present$message $printable");
ok (!brute_force_exists ($copy, $key),
"hv_delete_ent present$message $printable");
$copy = {%$hash};
ok (brute_force_exists ($copy, $key),
"hv_delete present$message $printable");
is (XS::APItest::Hash::delete ($copy, $key), $key,
"hv_delete present$message $printable");
ok (!brute_force_exists ($copy, $key),
"hv_delete present$message $printable");
}
sub test_delete_absent {
my ($hash, $key, $printable, $message) = @_;
my $copy = {};
my $class = tied %$hash;
if (defined $class) {
tie %$copy, ref $class;
}
$copy = {%$hash};
is (delete $copy->{$key}, undef, "hv_delete_ent absent$message $printable");
$copy = {%$hash};
is (XS::APItest::Hash::delete ($copy, $key), undef,
"hv_delete absent$message $printable");
}
sub test_store {
my ($hash, $key, $printable, $message, $defaults) = @_;
my $HV_STORE_IS_CRAZY = 1;
# We are cheating - hv_store returns NULL for a store into an empty
# tied hash. This isn't helpful here.
my $class = tied %$hash;
# It's important to do this with nice new hashes created each time round
# the loop, rather than hashes in the pad, which get recycled, and may have
# xhv_array non-NULL
my $h1 = {@$defaults};
my $h2 = {@$defaults};
if (defined $class) {
tie %$h1, ref $class;
tie %$h2, ref $class;
if ($] > 5.009) {
# bug 36327 is fixed
$HV_STORE_IS_CRAZY = undef;
} else {
# HV store_ent returns 1 if there was already underlying hash storage
$HV_STORE_IS_CRAZY = undef unless @$defaults;
}
}
is (XS::APItest::Hash::store_ent($h1, $key, 1), $HV_STORE_IS_CRAZY,
"hv_store_ent$message $printable");
ok (brute_force_exists ($h1, $key), "hv_store_ent$message $printable");
is (XS::APItest::Hash::store($h2, $key, 1), $HV_STORE_IS_CRAZY,
"hv_store$message $printable");
ok (brute_force_exists ($h2, $key), "hv_store$message $printable");
}
sub test_fetch_present {
my ($hash, $key, $printable, $message) = @_;
is ($hash->{$key}, $key, "hv_fetch_ent present$message $printable");
is (XS::APItest::Hash::fetch ($hash, $key), $key,
"hv_fetch present$message $printable");
}
sub test_fetch_absent {
my ($hash, $key, $printable, $message) = @_;
is ($hash->{$key}, undef, "hv_fetch_ent absent$message $printable");
is (XS::APItest::Hash::fetch ($hash, $key), undef,
"hv_fetch absent$message $printable");
}
sub brute_force_exists {
my ($hash, $key) = @_;
foreach (keys %$hash) {
return 1 if $key eq $_;
}
return 0;
}
sub rot13 {
my @results = map {my $a = $_; $a =~ tr/A-Za-z/N-ZA-Mn-za-m/; $a} @_;
wantarray ? @results : $results[0];
}
sub bitflip {
my $flip_bit = ord("A") ^ ord("a");
my @results = map {join '', map {chr($flip_bit ^ ord $_)} split '', $_} @_;
wantarray ? @results : $results[0];
}