1 package DBM::Deep::Hash;
6 use warnings FATAL => 'all';
7 no warnings 'recursion';
12 eval { local $SIG{'__DIE__'}; tied( %{$_[0]} ) } || $_[0]
15 sub _repr { return {} }
19 # Tied hash constructor method, called by Perl's tie() function.
22 my $args = $class->_get_args( @_ );
24 $args->{type} = $class->TYPE_HASH;
26 return $class->_init($args);
30 my $self = shift->_get_self;
31 DBM::Deep->_throw_error( "Cannot use an undefined hash key." ) unless defined $_[0];
32 my $key = ($self->_engine->storage->{filter_store_key})
33 ? $self->_engine->storage->{filter_store_key}->($_[0])
36 return $self->SUPER::FETCH( $key, $_[0] );
40 my $self = shift->_get_self;
41 DBM::Deep->_throw_error( "Cannot use an undefined hash key." ) unless defined $_[0];
42 my $key = ($self->_engine->storage->{filter_store_key})
43 ? $self->_engine->storage->{filter_store_key}->($_[0])
47 return $self->SUPER::STORE( $key, $value, $_[0] );
51 my $self = shift->_get_self;
52 DBM::Deep->_throw_error( "Cannot use an undefined hash key." ) unless defined $_[0];
53 my $key = ($self->_engine->storage->{filter_store_key})
54 ? $self->_engine->storage->{filter_store_key}->($_[0])
57 return $self->SUPER::EXISTS( $key );
61 my $self = shift->_get_self;
62 DBM::Deep->_throw_error( "Cannot use an undefined hash key." ) unless defined $_[0];
63 my $key = ($self->_engine->storage->{filter_store_key})
64 ? $self->_engine->storage->{filter_store_key}->($_[0])
67 return $self->SUPER::DELETE( $key, $_[0] );
72 # Locate and return first key (in no particular order)
74 my $self = shift->_get_self;
78 my $result = $self->_engine->get_next_key( $self );
82 return ($result && $self->_engine->storage->{filter_fetch_key})
83 ? $self->_engine->storage->{filter_fetch_key}->($result)
89 # Return next key (in no particular order), given previous one
91 my $self = shift->_get_self;
93 my $prev_key = ($self->_engine->storage->{filter_store_key})
94 ? $self->_engine->storage->{filter_store_key}->($_[0])
99 my $result = $self->_engine->get_next_key( $self, $prev_key );
103 return ($result && $self->_engine->storage->{filter_fetch_key})
104 ? $self->_engine->storage->{filter_fetch_key}->($result)
109 # Public method aliases
111 sub first_key { (shift)->FIRSTKEY(@_) }
112 sub next_key { (shift)->NEXTKEY(@_) }
118 my $key = $self->first_key();
119 while (defined $key) {
120 my $value = $self->get($key);
121 $self->_copy_value( \$db_temp->{$key}, $value );
122 $key = $self->next_key($key);