1 package DBM::Deep::Hash;
6 use warnings FATAL => 'all';
11 eval { local $SIG{'__DIE__'}; tied( %{$_[0]} ) } || $_[0]
14 sub _repr { return {} }
18 # Tied hash constructor method, called by Perl's tie() function.
21 my $args = $class->_get_args( @_ );
23 $args->{type} = $class->TYPE_HASH;
25 return $class->_init($args);
29 my $self = shift->_get_self;
30 DBM::Deep->_throw_error( "Cannot use an undefined hash key." ) unless defined $_[0];
31 my $key = ($self->_storage->{filter_store_key})
32 ? $self->_storage->{filter_store_key}->($_[0])
35 return $self->SUPER::FETCH( $key, $_[0] );
39 my $self = shift->_get_self;
40 DBM::Deep->_throw_error( "Cannot use an undefined hash key." ) unless defined $_[0];
41 my $key = ($self->_storage->{filter_store_key})
42 ? $self->_storage->{filter_store_key}->($_[0])
46 return $self->SUPER::STORE( $key, $value, $_[0] );
50 my $self = shift->_get_self;
51 DBM::Deep->_throw_error( "Cannot use an undefined hash key." ) unless defined $_[0];
52 my $key = ($self->_storage->{filter_store_key})
53 ? $self->_storage->{filter_store_key}->($_[0])
56 return $self->SUPER::EXISTS( $key );
60 my $self = shift->_get_self;
61 DBM::Deep->_throw_error( "Cannot use an undefined hash key." ) unless defined $_[0];
62 my $key = ($self->_storage->{filter_store_key})
63 ? $self->_storage->{filter_store_key}->($_[0])
66 return $self->SUPER::DELETE( $key, $_[0] );
71 # Locate and return first key (in no particular order)
73 my $self = shift->_get_self;
76 # Request shared lock for reading
78 $self->lock( $self->LOCK_SH );
80 my $result = $self->_engine->get_next_key( $self );
84 return ($result && $self->_storage->{filter_fetch_key})
85 ? $self->_storage->{filter_fetch_key}->($result)
91 # Return next key (in no particular order), given previous one
93 my $self = shift->_get_self;
95 my $prev_key = ($self->_storage->{filter_store_key})
96 ? $self->_storage->{filter_store_key}->($_[0])
100 # Request shared lock for reading
102 $self->lock( $self->LOCK_SH );
104 my $result = $self->_engine->get_next_key( $self, $prev_key );
108 return ($result && $self->_storage->{filter_fetch_key})
109 ? $self->_storage->{filter_fetch_key}->($result)
114 # Public method aliases
116 sub first_key { (shift)->FIRSTKEY(@_) }
117 sub next_key { (shift)->NEXTKEY(@_) }
123 my $key = $self->first_key();
125 my $value = $self->get($key);
126 $self->_copy_value( \$db_temp->{$key}, $value );
127 $key = $self->next_key($key);