From: Jarkko Hietaniemi Date: Fri, 18 Aug 2000 18:20:40 +0000 (+0000) Subject: Document the NDBM_File and ODBM_File as SDBM_File X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=0fbd2a467498985bda6ab127d71092089fb59bf2;p=p5sagit%2Fp5-mst-13.2.git Document the NDBM_File and ODBM_File as SDBM_File was documented in #6417. p4raw-id: //depot/perl@6701 --- diff --git a/ext/NDBM_File/NDBM_File.pm b/ext/NDBM_File/NDBM_File.pm index f98669f..c9ef699 100644 --- a/ext/NDBM_File/NDBM_File.pm +++ b/ext/NDBM_File/NDBM_File.pm @@ -24,15 +24,93 @@ NDBM_File - Tied access to ndbm files =head1 SYNOPSIS - use NDBM_File; - use Fcntl; # for O_ constants + use Fcntl; # For O_RDWR, O_CREAT, etc. + use NDBM_File; - tie(%h, 'NDBM_File', 'Op.dbmx', O_RDWR|O_CREAT, 0640); + # Now read and change the hash + $h{newkey} = newvalue; + print $h{oldkey}; + ... + + untie %h; + +=head1 DESCRIPTION + +C establishes a connection between a Perl hash variable and +a file in NDBM_File format;. You can manipulate the data in the file +just as if it were in a Perl hash, but when your program exits, the +data will remain in the file, to be used the next time your program +runs. - untie %h; +Use C with the Perl built-in C function to establish +the connection between the variable and the file. The arguments to +C should be: -=head1 DESCRIPTION +=over 4 + +=item 1. + +The hash variable you want to tie. + +=item 2. + +The string C<"NDBM_File">. (Ths tells Perl to use the C +package to perform the functions of the hash.) + +=item 3. + +The name of the file you want to tie to the hash. + +=item 4. + +Flags. Use one of: + +=over 2 + +=item C + +Read-only access to the data in the file. + +=item C + +Write-only access to the data in the file. + +=item C + +Both read and write access. + +=back + +If you want to create the file if it does not exist, add C to +any of these, as in the example. If you omit C and the file +does not already exist, the C call will fail. + +=item 5. + +The default permissions to use if a new file is created. The actual +permissions will be modified by the user's umask, so you should +probably use 0666 here. (See L.) + +=back + +=head1 DIAGNOSTICS + +On failure, the C call returns an undefined value and probably +sets C<$!> to contain the reason the file could not be tied. + +=head2 C + +This warning is emmitted when you try to store a key or a value that +is too long. It means that the change was not recorded in the +database. See BUGS AND WARNINGS below. + +=head1 BUGS AND WARNINGS + +There are a number of limits on the size of the data that you can +store in the NDBM file. The most important is that the length of a +key, plus the length of its associated value, may not exceed 1008 +bytes. -See L, L +See L, L, L =cut diff --git a/ext/ODBM_File/ODBM_File.pm b/ext/ODBM_File/ODBM_File.pm index 57fe4c3..732ed60 100644 --- a/ext/ODBM_File/ODBM_File.pm +++ b/ext/ODBM_File/ODBM_File.pm @@ -20,14 +20,93 @@ ODBM_File - Tied access to odbm files =head1 SYNOPSIS + use Fcntl; # For O_RDWR, O_CREAT, etc. use ODBM_File; - tie(%h, 'ODBM_File', 'Op.dbmx', O_RDWR|O_CREAT, 0640); + # Now read and change the hash + $h{newkey} = newvalue; + print $h{oldkey}; + ... + + untie %h; + +=head1 DESCRIPTION + +C establishes a connection between a Perl hash variable and +a file in ODBM_File format;. You can manipulate the data in the file +just as if it were in a Perl hash, but when your program exits, the +data will remain in the file, to be used the next time your program +runs. - untie %h; +Use C with the Perl built-in C function to establish +the connection between the variable and the file. The arguments to +C should be: -=head1 DESCRIPTION +=over 4 + +=item 1. + +The hash variable you want to tie. + +=item 2. + +The string C<"ODBM_File">. (Ths tells Perl to use the C +package to perform the functions of the hash.) + +=item 3. + +The name of the file you want to tie to the hash. + +=item 4. + +Flags. Use one of: + +=over 2 + +=item C + +Read-only access to the data in the file. + +=item C + +Write-only access to the data in the file. + +=item C + +Both read and write access. + +=back + +If you want to create the file if it does not exist, add C to +any of these, as in the example. If you omit C and the file +does not already exist, the C call will fail. + +=item 5. + +The default permissions to use if a new file is created. The actual +permissions will be modified by the user's umask, so you should +probably use 0666 here. (See L.) + +=back + +=head1 DIAGNOSTICS + +On failure, the C call returns an undefined value and probably +sets C<$!> to contain the reason the file could not be tied. + +=head2 C + +This warning is emmitted when you try to store a key or a value that +is too long. It means that the change was not recorded in the +database. See BUGS AND WARNINGS below. + +=head1 BUGS AND WARNINGS + +There are a number of limits on the size of the data that you can +store in the ODBM file. The most important is that the length of a +key, plus the length of its associated value, may not exceed 1008 +bytes. -See L, L +See L, L, L =cut diff --git a/ext/SDBM_File/SDBM_File.pm b/ext/SDBM_File/SDBM_File.pm index 438b8d0..b3502b9 100644 --- a/ext/SDBM_File/SDBM_File.pm +++ b/ext/SDBM_File/SDBM_File.pm @@ -103,8 +103,6 @@ This warning is emmitted when you try to store a key or a value that is too long. It means that the change was not recorded in the database. See BUGS AND WARNINGS below. - - =head1 BUGS AND WARNINGS There are a number of limits on the size of the data that you can