NAME

Hash::NoVivify - Perl extension for non-vivifying exists and defined functions

SYNOPSIS

use Hash::NoVivify qw(Defined Exists);

...

if (Exists(\%hash, qw(key1 key2 ... keyn ))) {
    ...
}

if (Defined(\%hash, qw(key1 key2 ... keyn))) {
    ...
}

DESCRIPTION

When used on a hash, the exists() and defined() functions will create entries in a hash in order to evaluate the function.

For instance, the code:

%a = (a => 1, b=> 2);
print "Doesn't exist\n" unless exists($a{c});
print "Also Doesn't exist\n" unless exists($a{c}->{d});
print "Oh, my, not good\n" if exists($a{c});

will print out:

Doesn't exist
Also Doesn't exist
Oh, my, not good

The Hash::NoVivify module provides two functions, Defined() and Exists(), which avoid this, at the cost of a slightly convoluted syntax. Both functions take a reference to a hash, followed by a list of descending keys defining the hash entry to be investigated.

AUTHOR

Brent B. Powers (B2Pi), Powers@B2Pi.com

Copyright(c) 1999 Brent B. Powers. All rights reserved. This program is free software, you may redistribute it and/or modify it under the same terms as Perl itself.

SEE ALSO

perl(1), perlfunc(1).