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; |
9426adcd |
49 | use XSLoader (); |
50 | @ISA = qw(Tie::Hash Exporter); |
a0d0e21e |
51 | @EXPORT = qw( |
52 | GDBM_CACHESIZE |
53 | GDBM_FAST |
54 | GDBM_INSERT |
55 | GDBM_NEWDB |
8722d079 |
56 | GDBM_NOLOCK |
a0d0e21e |
57 | GDBM_READER |
58 | GDBM_REPLACE |
59 | GDBM_WRCREAT |
60 | GDBM_WRITER |
61 | ); |
62 | |
97a5fa0b |
63 | $VERSION = "1.06"; |
c07a80fd |
64 | |
a0d0e21e |
65 | sub AUTOLOAD { |
96318ac8 |
66 | my($constname); |
a0d0e21e |
67 | ($constname = $AUTOLOAD) =~ s/.*:://; |
97a5fa0b |
68 | my ($error, $val) = constant($constname); |
69 | Carp::croak $error if $error; |
a0d0e21e |
70 | eval "sub $AUTOLOAD { $val }"; |
71 | goto &$AUTOLOAD; |
72 | } |
73 | |
9426adcd |
74 | XSLoader::load 'GDBM_File', $VERSION; |
a0d0e21e |
75 | |
a0d0e21e |
76 | 1; |