1 package DBM::Deep::Hash;
8 eval { tied( %{$_[0]} ) } || $_[0]
13 # Tied hash constructor method, called by Perl's tie() function.
19 $class->_throw_error( "Odd number of parameters to TIEHASH" );
23 #XXX This use of ref() is bad and is a bug
24 elsif (ref($_[0])) { $args = $_[0]; }
25 else { $args = { file => shift }; }
27 $args->{type} = $class->TYPE_HASH;
29 return $class->_init($args);
33 my $self = shift->_get_self;
34 my $key = ($self->root->{filter_store_key})
35 ? $self->root->{filter_store_key}->($_[0])
39 return $self->SUPER::STORE( $key, $value );
44 # Locate and return first key (in no particular order)
46 my $self = $_[0]->_get_self;
49 # Make sure file is open
51 if (!defined($self->fh)) { $self->_open(); }
54 # Request shared lock for reading
56 $self->lock( $self->LOCK_SH );
58 my $result = $self->_get_next_key();
62 return ($result && $self->root->{filter_fetch_key})
63 ? $self->root->{filter_fetch_key}->($result)
69 # Return next key (in no particular order), given previous one
71 my $self = $_[0]->_get_self;
73 my $prev_key = ($self->root->{filter_store_key})
74 ? $self->root->{filter_store_key}->($_[1])
77 my $prev_md5 = $DBM::Deep::DIGEST_FUNC->($prev_key);
80 # Make sure file is open
82 if (!defined($self->fh)) { $self->_open(); }
85 # Request shared lock for reading
87 $self->lock( $self->LOCK_SH );
89 my $result = $self->_get_next_key( $prev_md5 );
93 return ($result && $self->root->{filter_fetch_key})
94 ? $self->root->{filter_fetch_key}->($result)
99 # Public method aliases
101 *first_key = *FIRSTKEY;
102 *next_key = *NEXTKEY;