Gecko [ beriskala.com ]

Name	Size	Permission	Date
%5b%5d%3d-i.ri	405 B	-rw-r--r--	2023-07-26 17:38
%5b%5d-i.ri	404 B	-rw-r--r--	2023-07-26 17:38
cdesc-DBM.ri	5.45 KB	-rw-r--r--	2023-07-26 17:38
clear-i.ri	306 B	-rw-r--r--	2023-07-26 17:38
close-i.ri	291 B	-rw-r--r--	2023-07-26 17:38
closed%3f-i.ri	350 B	-rw-r--r--	2023-07-26 17:38
delete-i.ri	316 B	-rw-r--r--	2023-07-26 17:38
delete_if-i.ri	432 B	-rw-r--r--	2023-07-26 17:38
each-i.ri	386 B	-rw-r--r--	2023-07-26 17:38
each_key-i.ri	373 B	-rw-r--r--	2023-07-26 17:38
each_pair-i.ri	396 B	-rw-r--r--	2023-07-26 17:38
each_value-i.ri	383 B	-rw-r--r--	2023-07-26 17:38
empty%3f-i.ri	329 B	-rw-r--r--	2023-07-26 17:38
fetch-i.ri	478 B	-rw-r--r--	2023-07-26 17:38
has_key%3f-i.ri	371 B	-rw-r--r--	2023-07-26 17:38
has_value%3f-i.ri	395 B	-rw-r--r--	2023-07-26 17:38
include%3f-i.ri	371 B	-rw-r--r--	2023-07-26 17:38
invert-i.ri	419 B	-rw-r--r--	2023-07-26 17:38
key%3f-i.ri	363 B	-rw-r--r--	2023-07-26 17:38
key-i.ri	324 B	-rw-r--r--	2023-07-26 17:38
keys-i.ri	333 B	-rw-r--r--	2023-07-26 17:38
length-i.ri	331 B	-rw-r--r--	2023-07-26 17:38
member%3f-i.ri	369 B	-rw-r--r--	2023-07-26 17:38
new-c.ri	775 B	-rw-r--r--	2023-07-26 17:38
open-c.ri	450 B	-rw-r--r--	2023-07-26 17:38
reject%21-i.ri	428 B	-rw-r--r--	2023-07-26 17:38
reject-i.ri	444 B	-rw-r--r--	2023-07-26 17:38
replace-i.ri	466 B	-rw-r--r--	2023-07-26 17:38
select-i.ri	406 B	-rw-r--r--	2023-07-26 17:38
shift-i.ri	470 B	-rw-r--r--	2023-07-26 17:38
size-i.ri	327 B	-rw-r--r--	2023-07-26 17:38
store-i.ri	409 B	-rw-r--r--	2023-07-26 17:38
to_a-i.ri	373 B	-rw-r--r--	2023-07-26 17:38
to_hash-i.ri	374 B	-rw-r--r--	2023-07-26 17:38
update-i.ri	451 B	-rw-r--r--	2023-07-26 17:38
value%3f-i.ri	387 B	-rw-r--r--	2023-07-26 17:38
values-i.ri	341 B	-rw-r--r--	2023-07-26 17:38
values_at-i.ri	377 B	-rw-r--r--	2023-07-26 17:38

Rename

U:RDoc::NormalClass[iI"DBM:ET@I"Object;To:RDoc::Markup::Document:@parts[o;;[o:RDoc::Markup::Paragraph;[I")Documented by mathew meta@pobox.com.;TS:RDoc::Markup::Heading:
leveli:	textI"Introduction;To:RDoc::Markup::BlankLine�o;	;[I"6The DBM class provides a wrapper to a Unix-style ;TI"I{dbm}[http://en.wikipedia.org/wiki/Dbm] or Database Manager library.;T@o;	;[I"LDbm databases do not have tables or columns; they are simple key-value ;TI"Odata stores, like a Ruby Hash except not resident in RAM. Keys and values ;TI"must be strings.;T@o;	;[I"NThe exact library used depends on how Ruby was compiled. It could be any ;TI"of the following:;T@o:RDoc::Markup::List:
@type:BULLET:@items[
o:RDoc::Markup::ListItem:@label0;[o;	;[I"6The original ndbm library is released in 4.3BSD. ;TI"KIt is based on dbm library in Unix Version 7 but has different API to ;TI"-support multiple databases in a process.;To;;0;[o;	;[I"F{Berkeley DB}[http://en.wikipedia.org/wiki/Berkeley_DB] versions ;TI"G1 thru 5, also known as BDB and Sleepycat DB, now owned by Oracle ;TI"Corporation.;To;;0;[o;	;[I"PBerkeley DB 1.x, still found in 4.4BSD derivatives (FreeBSD, OpenBSD, etc).;To;;0;[o;	;[I"N{gdbm}[http://www.gnu.org/software/gdbm/], the GNU implementation of dbm.;To;;0;[o;	;[I"E{qdbm}[http://fallabs.com/qdbm/index.html], another open source ;TI"reimplementation of dbm.;T@o;	;[I"EAll of these dbm implementations have their own Ruby interfaces ;TI"8available, which provide richer (but varying) APIs.;T@S;
;i;I"
Cautions;T@o;	;[I"MBefore you decide to use DBM, there are some issues you should consider:;T@o;;;;[	o;;0;[o;	;[I"HEach implementation of dbm has its own file format. Generally, dbm ;TI"Flibraries will not read each other's files. This makes dbm files ;TI"$a bad choice for data exchange.;T@o;;0;[o;	;[I"LEven running the same OS and the same dbm implementation, the database ;TI"Lfile format may depend on the CPU architecture. For example, files may ;TI"Mnot be portable between PowerPC and 386, or between 32 and 64 bit Linux.;T@o;;0;[o;	;[I"ODifferent versions of Berkeley DB use different file formats. A change to ;TI"=the OS may therefore break DBM access to existing files.;T@o;;0;[o;	;[
I"MData size limits vary between implementations. Original Berkeley DB was ;TI"Jlimited to 2GB of data. Dbm libraries also sometimes limit the total ;TI"Lsize of a key/value pair, and the total size of all the keys that hash ;TI"Oto the same value. These limits can be as little as 512 bytes. That said, ;TI"Ggdbm and recent versions of Berkeley DB do away with these limits.;T@o;	;[I"QGiven the above cautions, DBM is not a good choice for long term storage of ;TI"Mimportant data. It is probably best used as a fast and easy alternative ;TI"4to a Hash for processing large amounts of data.;T@S;
;i;I"Example;T@o:RDoc::Markup::Verbatim;[I"require 'dbm'
;TI".db = DBM.open('rfcs', 666, DBM::CREATRW)
;TI"Jdb['822'] = 'Standard for the Format of ARPA Internet Text Messages'
;TI"Ndb['1123'] = 'Requirements for Internet Hosts - Application and Support'
;TI"=db['3068'] = 'An Anycast Prefix for 6to4 Relay Routers'
;TI"puts db['822'];T:@format0:
@fileI"ext/dbm/dbm.c;T:0@omit_headings_from_table_of_contents_below0;0;0[�[
U:RDoc::Constant[i�I"READER;TI"DBM::READER;T00o;;[o;	;[I"IIndicates that dbm_open() should open the database in read-only mode;T@;@w;0@w@cRDoc::NormalClass0U;[i�I"WRITER;TI"DBM::WRITER;T00o;;[o;	;[I"JIndicates that dbm_open() should open the database in read/write mode;T@;@w;0@w@@~0U;[i�I"WRCREAT;TI"DBM::WRCREAT;T00o;;[o;	;[I"LIndicates that dbm_open() should open the database in read/write mode, ;TI"/and create it if it does not already exist;T;@w;0@w@@~0U;[i�I"
NEWDB;TI"DBM::NEWDB;T00o;;[o;	;[I"LIndicates that dbm_open() should open the database in read/write mode, ;TI"Kcreate it if it does not already exist, and delete all contents if it ;TI"does already exist.;T;@w;0@w@@~0U;[i�I"VERSION;TI"DBM::VERSION;T00o;;[
o;	;[I"%Identifies ndbm library version.;T@o;	;[I"Examples:;T@o;;;;[
o;;0;[o;	;[I""ndbm (4.3BSD)";To;;0;[o;	;[I"+"Berkeley DB 4.8.30: (April  9, 2010)";To;;0;[o;	;[I","Berkeley DB (unknown)" (4.4BSD, maybe);To;;0;[o;	;[I"B"GDBM version 1.8.3. 10/15/2002 (built Jul  1 2011 12:32:45)";To;;0;[o;	;[I""QDBM 1.8.78";T;@w;0@w@@~0[[I"Enumerable;To;;[�;@w;0I"ext/dbm/dbm.c;T[[I"
class;T[[:public[[I"new;T@�[I"	open;T@�[:protected[�[:private[�[I"
instance;T[[;[([I"[];T@�[I"[]=;T@�[I"
clear;T@�[I"
close;T@�[I"closed?;T@�[I"delete;T@�[I"delete_if;T@�[I"	each;T@�[I"
each_key;T@�[I"each_pair;T@�[I"each_value;T@�[I"empty?;T@�[I"
fetch;T@�[I"
has_key?;T@�[I"has_value?;T@�[I"
include?;T@�[I"invert;T@�[I"key;T@�[I"	key?;T@�[I"	keys;T@�[I"length;T@�[I"member?;T@�[I"reject;T@�[I"reject!;T@�[I"replace;T@�[I"select;T@�[I"
shift;T@�[I"	size;T@�[I"
store;T@�[I"	to_a;T@�[I"to_hash;T@�[I"update;T@�[I"value?;T@�[I"values;T@�[I"values_at;T@�[;[�[;[�[�[U:RDoc::Context::Section[i�0o;;[�;0;0[@w@wcRDoc::TopLevel