Commit | Line | Data |
4633a7c4 |
1 | # GDBM_File.pm -- Perl 5 interface to GNU gdbm library. |
bd81798f |
2 | |
4633a7c4 |
3 | =head1 NAME |
4 | |
5 | GDBM_File - Perl5 access to the gdbm library. |
6 | |
7 | =head1 SYNOPSIS |
8 | |
9 | use GDBM_File ; |
02c45c47 |
10 | tie %hash, 'GDBM_File', $filename, &GDBM_WRCREAT, 0640; |
4633a7c4 |
11 | # Use the %hash array. |
12 | untie %hash ; |
13 | |
14 | =head1 DESCRIPTION |
15 | |
16 | B<GDBM_File> is a module which allows Perl programs to make use of the |
17 | facilities provided by the GNU gdbm library. If you intend to use this |
18 | module you should really have a copy of the gdbm manualpage at hand. |
19 | |
20 | Most of the libgdbm.a functions are available through the GDBM_File |
21 | interface. |
22 | |
23 | =head1 AVAILABILITY |
24 | |
25 | Gdbm is available from any GNU archive. The master site is |
26 | C<prep.ai.mit.edu>, but your are strongly urged to use one of the many |
27 | mirrors. You can obtain a list of mirror sites by issuing the |
28 | command C<finger fsf@prep.ai.mit.edu>. |
29 | |
30 | =head1 BUGS |
31 | |
32 | The available functions and the gdbm/perl interface need to be documented. |
33 | |
34 | =head1 SEE ALSO |
35 | |
9fe6733a |
36 | L<perl(1)>, L<DB_File(3)>, L<perldbmfilter>. |
4633a7c4 |
37 | |
38 | =cut |
39 | |
a0d0e21e |
40 | package GDBM_File; |
41 | |
96318ac8 |
42 | use strict; |
698828ad |
43 | use warnings; |
17f410f9 |
44 | our($VERSION, @ISA, @EXPORT, $AUTOLOAD); |
96318ac8 |
45 | |
a0d0e21e |
46 | require Carp; |
96318ac8 |
47 | require Tie::Hash; |
a0d0e21e |
48 | require Exporter; |
3b35bae3 |
49 | use AutoLoader; |
9426adcd |
50 | use XSLoader (); |
51 | @ISA = qw(Tie::Hash Exporter); |
a0d0e21e |
52 | @EXPORT = qw( |
53 | GDBM_CACHESIZE |
54 | GDBM_FAST |
55 | GDBM_INSERT |
56 | GDBM_NEWDB |
8722d079 |
57 | GDBM_NOLOCK |
a0d0e21e |
58 | GDBM_READER |
59 | GDBM_REPLACE |
60 | GDBM_WRCREAT |
61 | GDBM_WRITER |
62 | ); |
63 | |
8722d079 |
64 | $VERSION = "1.05"; |
c07a80fd |
65 | |
a0d0e21e |
66 | sub AUTOLOAD { |
96318ac8 |
67 | my($constname); |
a0d0e21e |
68 | ($constname = $AUTOLOAD) =~ s/.*:://; |
96318ac8 |
69 | my $val = constant($constname, @_ ? $_[0] : 0); |
a0d0e21e |
70 | if ($! != 0) { |
265f5c4a |
71 | if ($! =~ /Invalid/ || $!{EINVAL}) { |
a0d0e21e |
72 | $AutoLoader::AUTOLOAD = $AUTOLOAD; |
73 | goto &AutoLoader::AUTOLOAD; |
74 | } |
75 | else { |
76 | Carp::croak("Your vendor has not defined GDBM_File macro $constname, used"); |
77 | } |
78 | } |
79 | eval "sub $AUTOLOAD { $val }"; |
80 | goto &$AUTOLOAD; |
81 | } |
82 | |
9426adcd |
83 | XSLoader::load 'GDBM_File', $VERSION; |
a0d0e21e |
84 | |
85 | # Preloaded methods go here. Autoload methods go after __END__, and are |
86 | # processed by the autosplit program. |
87 | |
88 | 1; |
89 | __END__ |