diff options
author | matz <matz@b2dd03c8-39d4-4d8f-98ff-823fe69b080e> | 2006-09-20 00:30:38 +0000 |
---|---|---|
committer | matz <matz@b2dd03c8-39d4-4d8f-98ff-823fe69b080e> | 2006-09-20 00:30:38 +0000 |
commit | d5219a4c3394ef2941fa76c7a27b3c22d5f192bf (patch) | |
tree | 473d507b8c583cb123313658eee5c7dee60e81f5 /ext | |
parent | ade8810ef720dfd6976582a884059c9a2e4d4769 (diff) |
* ext/gdbm/gdbm.c: add RDoc documentation. a patch from Peter
Adolphs <futzilogik at users dot sourceforge dot net>.
[ruby-doc:1223]
git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/branches/ruby_1_8@10965 b2dd03c8-39d4-4d8f-98ff-823fe69b080e
Diffstat (limited to 'ext')
-rw-r--r-- | ext/gdbm/gdbm.c | 412 |
1 files changed, 374 insertions, 38 deletions
diff --git a/ext/gdbm/gdbm.c b/ext/gdbm/gdbm.c index d50cb91eed..e49932f132 100644 --- a/ext/gdbm/gdbm.c +++ b/ext/gdbm/gdbm.c @@ -6,6 +6,8 @@ $Date$ modified at: Mon Jan 24 15:59:52 JST 1994 + Documentation by Peter Adolphs < futzilogik at users dot sourceforge dot net > + ************************************************/ #include "ruby.h" @@ -14,6 +16,62 @@ #include <fcntl.h> #include <errno.h> +/* + * Document-class: GDBM + * + * == Summary + * + * Ruby extension for GNU dbm (gdbm) -- a simple database engine for storing + * key-value pairs on disk. + * + * == Description + * + * GNU dbm is a library for simple databases. A database is a file that stores + * key-value pairs. Gdbm allows the user to store, retrieve, and delete data by + * key. It furthermore allows a non-sorted traversal of all key-value pairs. + * A gdbm database thus provides the same functionality as a hash. As + * with objects of the Hash class, elements can be accessed with <tt>[]</tt>. + * Furthermore, GDBM mixes in the Enumerable module, thus providing convenient + * methods such as #find, #collect, #map, etc. + * + * A process is allowed to open several different databases at the same time. + * A process can open a database as a "reader" or a "writer". Whereas a reader + * has only read-access to the database, a writer has read- and write-access. + * A database can be accessed either by any number of readers or by exactly one + * writer at the same time. + * + * == Examples + * + * 1. Opening/creating a database, and filling it with some entries: + * + * require 'gdbm' + * + * gdbm = GDBM.new("fruitstore.db") + * gdbm["ananas"] = "3" + * gdbm["banana"] = "8" + * gdbm["cranberry"] = "4909" + * gdbm.close + * + * 2. Reading out a database: + * + * require 'gdbm' + * + * gdbm = GDBM.new("fruitstore.db") + * gdbm.each_pair do |key, value| + * print "#{key}: #{value}\n" + * end + * gdbm.close + * + * produces + * + * banana: 8 + * ananas: 3 + * cranberry: 4909 + * + * == Links + * + * * http://www.gnu.org/software/gdbm/ + */ static VALUE rb_cGDBM, rb_eGDBMError, rb_eGDBMFatalError; #define RUBY_GDBM_RW_BIT 0x20000000 @@ -54,11 +112,17 @@ free_dbm(dbmp) struct dbmdata *dbmp; { if (dbmp) { - if (dbmp->di_dbm) gdbm_close(dbmp->di_dbm); - free(dbmp); + if (dbmp->di_dbm) gdbm_close(dbmp->di_dbm); + free(dbmp); } } +/* + * call-seq: + * gdbm.close -> nil + * + * Closes the associated database file. + */ static VALUE fgdbm_close(obj) VALUE obj; @@ -72,6 +136,12 @@ fgdbm_close(obj) return Qnil; } +/* + * call-seq: + * gdbm.closed? -> true or false + * + * Returns true if the associated database file has been closed. + */ static VALUE fgdbm_closed(obj) VALUE obj; @@ -80,9 +150,9 @@ fgdbm_closed(obj) Data_Get_Struct(obj, struct dbmdata, dbmp); if (dbmp == 0) - return Qtrue; + return Qtrue; if (dbmp->di_dbm == 0) - return Qtrue; + return Qtrue; return Qfalse; } @@ -96,6 +166,29 @@ fgdbm_s_alloc(klass) return Data_Wrap_Struct(klass, 0, free_dbm, 0); } +/* + * call-seq: + * GDBM.new(filename, mode = 0666, flags = nil) + * + * Creates a new GDBM instance by opening a gdbm file named _filename_. + * If the file does not exist, a new file with file mode _mode_ will be + * created. _flags_ may be one of the following: + * * *READER* - open as a reader + * * *WRITER* - open as a writer + * * *WRCREAT* - open as a writer; if the database does not exist, create a new one + * * *NEWDB* - open as a writer; overwrite any existing databases + * + * The values *WRITER*, *WRCREAT* and *NEWDB* may be combined with the following + * values by bitwise or: + * * *SYNC* - cause all database operations to be synchronized to the disk + * * *NOLOCK* - do not lock the database file + * + * If no _flags_ are specified, the GDBM object will try to open the database + * file as a writer and will create it if it does not already exist + * (cf. flag <tt>WRCREAT</tt>). If this fails (for instance, if another process + * has already opened the database as a reader), it will try to open the + * database file as a reader (cf. flag <tt>READER</tt>). + */ static VALUE fgdbm_initialize(argc, argv, obj) int argc; @@ -108,13 +201,13 @@ fgdbm_initialize(argc, argv, obj) int mode, flags = 0; if (rb_scan_args(argc, argv, "12", &file, &vmode, &vflags) == 1) { - mode = 0666; /* default value */ + mode = 0666; /* default value */ } else if (NIL_P(vmode)) { - mode = -1; /* return nil if DB not exist */ + mode = -1; /* return nil if DB does not exist */ } else { - mode = NUM2INT(vmode); + mode = NUM2INT(vmode); } if (!NIL_P(vflags)) @@ -160,6 +253,25 @@ fgdbm_initialize(argc, argv, obj) return obj; } +/* + * call-seq: + * GDBM.open(filename, mode = 0666, flags = nil) + * GDBM.open(filename, mode = 0666, flags = nil) { |gdbm| ... } + * + * If called without a block, this is synonymous to GDBM::new. + * If a block is given, the new GDBM instance will be passed to the block + * as a parameter, and the corresponding database file will be closed + * after the execution of the block code has been finished. + * + * Example for an open call with a block: + * + * require 'gdbm' + * GDBM.open("fruitstore.db") do |gdbm| + * gdbm.each_pair do |key, value| + * print "#{key}: #{value}\n" + * end + * end + */ static VALUE fgdbm_s_open(argc, argv, klass) int argc; @@ -286,6 +398,12 @@ fgdbm_fetch(obj, keystr, ifnone) return valstr; } +/* + * call-seq: + * gdbm[key] -> value + * + * Retrieves the _value_ corresponding to _key_. + */ static VALUE fgdbm_aref(obj, keystr) VALUE obj, keystr; @@ -293,6 +411,13 @@ fgdbm_aref(obj, keystr) return rb_gdbm_fetch3(obj, keystr); } +/* + * call-seq: + * gdbm.fetch(key [, default]) -> value + * + * Retrieves the _value_ corresponding to _key_. If there is no value + * associated with _key_, _default_ will be returned instead. + */ static VALUE fgdbm_fetch_m(argc, argv, obj) int argc; @@ -304,11 +429,18 @@ fgdbm_fetch_m(argc, argv, obj) rb_scan_args(argc, argv, "11", &keystr, &ifnone); valstr = fgdbm_fetch(obj, keystr, ifnone); if (argc == 1 && !rb_block_given_p() && NIL_P(valstr)) - rb_raise(rb_eIndexError, "key not found"); + rb_raise(rb_eIndexError, "key not found"); return valstr; } +/* + * call-seq: + * gdbm.index(value) -> key + * + * Returns the _key_ for a given _value_. If several keys may map to the + * same value, the key that is found first will be returned. + */ static VALUE fgdbm_index(obj, valstr) VALUE obj, valstr; @@ -350,6 +482,13 @@ fgdbm_indexes(argc, argv, obj) return new; } +/* + * call-seq: + * gdbm.select { |value| block } -> array + * + * Returns a new array of all values of the database for which _block_ + * evaluates to true. + */ static VALUE fgdbm_select(argc, argv, obj) int argc; @@ -390,6 +529,12 @@ fgdbm_select(argc, argv, obj) return new; } +/* + * call-seq: + * gdbm.values_at(key, ...) -> array + * + * Returns an array of the values associated with each specified _key_. + */ static VALUE fgdbm_values_at(argc, argv, obj) int argc; @@ -429,19 +574,26 @@ rb_gdbm_delete(obj, keystr) GetDBM2(obj, dbmp, dbm); if (!gdbm_exists(dbm, key)) { - return Qnil; + return Qnil; } if (gdbm_delete(dbm, key)) { - dbmp->di_size = -1; - rb_raise(rb_eGDBMError, "%s", gdbm_strerror(gdbm_errno)); + dbmp->di_size = -1; + rb_raise(rb_eGDBMError, "%s", gdbm_strerror(gdbm_errno)); } else if (dbmp->di_size >= 0) { - dbmp->di_size--; + dbmp->di_size--; } return obj; } +/* + * call-seq: + * gdbm.delete(key) -> value or nil + * + * Removes the key-value-pair with the specified _key_ from this database and + * returns the corresponding _value_. Returns nil if the database is empty. + */ static VALUE fgdbm_delete(obj, keystr) VALUE obj, keystr; @@ -453,6 +605,13 @@ fgdbm_delete(obj, keystr) return valstr; } +/* + * call-seq: + * gdbm.shift -> (key, value) or nil + * + * Removes a key-value-pair from this database and returns it as a + * two-item array [ _key_, _value_ ]. Returns nil if the database is empty. + */ static VALUE fgdbm_shift(obj) VALUE obj; @@ -471,6 +630,13 @@ fgdbm_shift(obj) return rb_assoc_new(keystr, valstr); } +/* + * call-seq: + * gdbm.delete_if { |key, value| block } -> gdbm + * gdbm.reject! { |key, value| block } -> gdbm + * + * Deletes every key-value pair from _gdbm_ for which _block_ evaluates to true. + */ static VALUE fgdbm_delete_if(obj) VALUE obj; @@ -489,11 +655,11 @@ fgdbm_delete_if(obj) for (keystr = rb_gdbm_firstkey(dbm); RTEST(keystr); keystr = rb_gdbm_nextkey(dbm, keystr)) { - valstr = rb_gdbm_fetch2(dbm, keystr); + valstr = rb_gdbm_fetch2(dbm, keystr); ret = rb_protect(rb_yield, rb_assoc_new(keystr, valstr), &status); if (status != 0) break; - if (RTEST(ret)) rb_ary_push(ary, keystr); - GetDBM2(obj, dbmp, dbm); + if (RTEST(ret)) rb_ary_push(ary, keystr); + GetDBM2(obj, dbmp, dbm); } for (i = 0; i < RARRAY(ary)->len; i++) @@ -504,6 +670,12 @@ fgdbm_delete_if(obj) return obj; } +/* + * call-seq: + * gdbm.clear -> gdbm + * + * Removes all the key-value pairs within _gdbm_. + */ static VALUE fgdbm_clear(obj) VALUE obj; @@ -518,11 +690,11 @@ fgdbm_clear(obj) #if 0 while (key = gdbm_firstkey(dbm), key.dptr) { - if (gdbm_delete(dbm, key)) { - free(key.dptr); - rb_raise(rb_eGDBMError, "%s", gdbm_strerror(gdbm_errno)); - } - free(key.dptr); + if (gdbm_delete(dbm, key)) { + free(key.dptr); + rb_raise(rb_eGDBMError, "%s", gdbm_strerror(gdbm_errno)); + } + free(key.dptr); } #else while (key = gdbm_firstkey(dbm), key.dptr) { @@ -542,6 +714,13 @@ fgdbm_clear(obj) return obj; } +/* + * call-seq: + * gdbm.invert -> hash + * + * Returns a hash created by using _gdbm_'s values as keys, and the keys + * as values. + */ static VALUE fgdbm_invert(obj) VALUE obj; @@ -584,6 +763,14 @@ update_i(pair, dbm) return Qnil; } +/* + * call-seq: + * gdbm.update(other) -> gdbm + * + * Adds the key-value pairs of _other_ to _gdbm_, overwriting entries with + * duplicate keys with those from _other_. _other_ must have an each_pair + * method. + */ static VALUE fgdbm_update(obj, other) VALUE obj, other; @@ -592,6 +779,13 @@ fgdbm_update(obj, other) return obj; } +/* + * call-seq: + * gdbm.replace(other) -> gdbm + * + * Replaces the content of _gdbm_ with the key-value pairs of _other_. + * _other_ must have an each_pair method. + */ static VALUE fgdbm_replace(obj, other) VALUE obj, other; @@ -601,6 +795,13 @@ fgdbm_replace(obj, other) return obj; } +/* + * call-seq: + * gdbm[key]= value -> value + * gdbm.store(key, value) -> value + * + * Associates the value _value_ with the specified _key_. + */ static VALUE fgdbm_store(obj, keystr, valstr) VALUE obj, keystr, valstr; @@ -622,13 +823,20 @@ fgdbm_store(obj, keystr, valstr) GetDBM2(obj, dbmp, dbm); dbmp->di_size = -1; if (gdbm_store(dbm, key, val, GDBM_REPLACE)) { - if (errno == EPERM) rb_sys_fail(0); - rb_raise(rb_eGDBMError, "%s", gdbm_strerror(gdbm_errno)); + if (errno == EPERM) rb_sys_fail(0); + rb_raise(rb_eGDBMError, "%s", gdbm_strerror(gdbm_errno)); } return valstr; } +/* + * call-seq: + * gdbm.length -> fixnum + * gdbm.size -> fixnum + * + * Returns the number of key-value pairs in this database. + */ static VALUE fgdbm_length(obj) VALUE obj; @@ -651,6 +859,12 @@ fgdbm_length(obj) return INT2FIX(i); } +/* + * call-seq: + * gdbm.empty? -> true or false + * + * Returns true if the database is empty. + */ static VALUE fgdbm_empty_p(obj) VALUE obj; @@ -675,6 +889,13 @@ fgdbm_empty_p(obj) return Qfalse; } +/* + * call-seq: + * gdbm.each_value { |value| block } -> gdbm + * + * Executes _block_ for each key in the database, passing the corresponding + * _value_ as a parameter. + */ static VALUE fgdbm_each_value(obj) VALUE obj; @@ -693,6 +914,13 @@ fgdbm_each_value(obj) return obj; } +/* + * call-seq: + * gdbm.each_key { |key| block } -> gdbm + * + * Executes _block_ for each key in the database, passing the + * _key_ as a parameter. + */ static VALUE fgdbm_each_key(obj) VALUE obj; @@ -711,6 +939,13 @@ fgdbm_each_key(obj) return obj; } +/* + * call-seq: + * gdbm.each_pair { |key, value| block } -> gdbm + * + * Executes _block_ for each key in the database, passing the _key_ and the + * correspoding _value_ as a parameter. + */ static VALUE fgdbm_each_pair(obj) VALUE obj; @@ -724,12 +959,18 @@ fgdbm_each_pair(obj) keystr = rb_gdbm_nextkey(dbm, keystr)) { rb_yield(rb_assoc_new(keystr, rb_gdbm_fetch2(dbm, keystr))); - GetDBM2(obj, dbmp, dbm); + GetDBM2(obj, dbmp, dbm); } return obj; } +/* + * call-seq: + * gdbm.keys -> array + * + * Returns an array of all keys of this database. + */ static VALUE fgdbm_keys(obj) VALUE obj; @@ -749,6 +990,12 @@ fgdbm_keys(obj) return ary; } +/* + * call-seq: + * gdbm.values -> array + * + * Returns an array of all values of this database. + */ static VALUE fgdbm_values(obj) VALUE obj; @@ -762,14 +1009,22 @@ fgdbm_values(obj) ary = rb_ary_new(); for (key = gdbm_firstkey(dbm); key.dptr; key = nextkey) { nextkey = gdbm_nextkey(dbm, key); - valstr = rb_gdbm_fetch(dbm, key); + valstr = rb_gdbm_fetch(dbm, key); free(key.dptr); - rb_ary_push(ary, valstr); + rb_ary_push(ary, valstr); } return ary; } +/* + * call-seq: + * gdbm.has_key?(k) -> true or false + * gdbm.key?(k) -> true or false + * + * Returns true if the given key _k_ exists within the database. + * Returns false otherwise. + */ static VALUE fgdbm_has_key(obj, keystr) VALUE obj, keystr; @@ -788,6 +1043,14 @@ fgdbm_has_key(obj, keystr) return Qfalse; } +/* + * call-seq: + * gdbm.has_value?(v) -> true or false + * gdbm.value?(v) -> true or false + * + * Returns true if the given value _v_ exists within the database. + * Returns false otherwise. + */ static VALUE fgdbm_has_value(obj, valstr) VALUE obj, valstr; @@ -813,6 +1076,12 @@ fgdbm_has_value(obj, valstr) return Qfalse; } +/* + * call-seq: + * gdbm.to_a -> array + * + * Returns an array of all key-value pairs contained in the database. + */ static VALUE fgdbm_to_a(obj) VALUE obj; @@ -832,6 +1101,14 @@ fgdbm_to_a(obj) return ary; } +/* + * call-seq: + * gdbm.reorganize -> gdbm + * + * Reorganizes the database file. This operation removes reserved space of + * elements that have already been deleted. It is only useful after a lot of + * deletions in the database. + */ static VALUE fgdbm_reorganize(obj) VALUE obj; @@ -845,6 +1122,16 @@ fgdbm_reorganize(obj) return obj; } +/* + * call-seq: + * gdbm.sync -> gdbm + * + * Unless the _gdbm_ object has been opened with the *SYNC* flag, it is not + * guarenteed that database modification operations are immediately applied to + * the database file. This method ensures that all recent modifications + * to the database are written to the file. Blocks until all writing operations + * to the disk have been finished. + */ static VALUE fgdbm_sync(obj) VALUE obj; @@ -858,6 +1145,12 @@ fgdbm_sync(obj) return obj; } +/* + * call-seq: + * gdbm.cachesize = size -> size + * + * Sets the size of the internal bucket cache to _size_. + */ static VALUE fgdbm_set_cachesize(obj, val) VALUE obj, val; @@ -869,11 +1162,21 @@ fgdbm_set_cachesize(obj, val) GetDBM2(obj, dbmp, dbm); optval = FIX2INT(val); if (gdbm_setopt(dbm, GDBM_CACHESIZE, &optval, sizeof(optval)) == -1) { - rb_raise(rb_eGDBMError, "%s", gdbm_strerror(gdbm_errno)); + rb_raise(rb_eGDBMError, "%s", gdbm_strerror(gdbm_errno)); } return val; } +/* + * call-seq: + * gdbm.fastmode = boolean -> boolean + * + * Turns the database's fast mode on or off. If fast mode is turned on, gdbm + * does not wait for writes to be flushed to the disk before continuing. + * + * This option is obsolete for gdbm >= 1.8 since fast mode is turned on by + * default. See also: #syncmode= + */ static VALUE fgdbm_set_fastmode(obj, val) VALUE obj, val; @@ -888,11 +1191,24 @@ fgdbm_set_fastmode(obj, val) optval = 1; if (gdbm_setopt(dbm, GDBM_FASTMODE, &optval, sizeof(optval)) == -1) { - rb_raise(rb_eGDBMError, "%s", gdbm_strerror(gdbm_errno)); + rb_raise(rb_eGDBMError, "%s", gdbm_strerror(gdbm_errno)); } return val; } +/* + * call-seq: + * gdbm.syncmode = boolean -> boolean + * + * Turns the database's synchronization mode on or off. If the synchronization + * mode is turned on, the database's in-memory state will be synchronized to + * disk after every database modification operation. If the synchronization + * mode is turned off, GDBM does not wait for writes to be flushed to the disk + * before continuing. + * + * This option is only available for gdbm >= 1.8 where syncmode is turned off + * by default. See also: #fastmode= + */ static VALUE fgdbm_set_syncmode(obj, val) VALUE obj, val; @@ -911,12 +1227,18 @@ fgdbm_set_syncmode(obj, val) optval = 1; if (gdbm_setopt(dbm, GDBM_FASTMODE, &optval, sizeof(optval)) == -1) { - rb_raise(rb_eGDBMError, "%s", gdbm_strerror(gdbm_errno)); + rb_raise(rb_eGDBMError, "%s", gdbm_strerror(gdbm_errno)); } return val; #endif } +/* + * call-seq: + * gdbm.to_hash -> hash + * + * Returns a hash of all key-value pairs contained in the database. + */ static VALUE fgdbm_to_hash(obj) VALUE obj; @@ -936,6 +1258,13 @@ fgdbm_to_hash(obj) return hash; } +/* + * call-seq: + * gdbm.reject { |key, value| block } -> hash + * + * Returns a hash copy of _gdbm_ where all key-value pairs from _gdbm_ for + * which _block_ evaluates to true are removed. See also: #delete_if + */ static VALUE fgdbm_reject(obj) VALUE obj; @@ -981,15 +1310,15 @@ Init_gdbm() rb_define_method(rb_cGDBM, "reject!", fgdbm_delete_if, 0); rb_define_method(rb_cGDBM, "reject", fgdbm_reject, 0); rb_define_method(rb_cGDBM, "clear", fgdbm_clear, 0); - rb_define_method(rb_cGDBM,"invert", fgdbm_invert, 0); - rb_define_method(rb_cGDBM,"update", fgdbm_update, 1); - rb_define_method(rb_cGDBM,"replace", fgdbm_replace, 1); - rb_define_method(rb_cGDBM,"reorganize", fgdbm_reorganize, 0); - rb_define_method(rb_cGDBM,"sync", fgdbm_sync, 0); - /* rb_define_method(rb_cGDBM,"setopt", fgdbm_setopt, 2); */ - rb_define_method(rb_cGDBM,"cachesize=", fgdbm_set_cachesize, 1); - rb_define_method(rb_cGDBM,"fastmode=", fgdbm_set_fastmode, 1); - rb_define_method(rb_cGDBM,"syncmode=", fgdbm_set_syncmode, 1); + rb_define_method(rb_cGDBM, "invert", fgdbm_invert, 0); + rb_define_method(rb_cGDBM, "update", fgdbm_update, 1); + rb_define_method(rb_cGDBM, "replace", fgdbm_replace, 1); + rb_define_method(rb_cGDBM, "reorganize", fgdbm_reorganize, 0); + rb_define_method(rb_cGDBM, "sync", fgdbm_sync, 0); + /* rb_define_method(rb_cGDBM, "setopt", fgdbm_setopt, 2); */ + rb_define_method(rb_cGDBM, "cachesize=", fgdbm_set_cachesize, 1); + rb_define_method(rb_cGDBM, "fastmode=", fgdbm_set_fastmode, 1); + rb_define_method(rb_cGDBM, "syncmode=", fgdbm_set_syncmode, 1); rb_define_method(rb_cGDBM, "include?", fgdbm_has_key, 1); rb_define_method(rb_cGDBM, "has_key?", fgdbm_has_key, 1); @@ -1001,22 +1330,29 @@ Init_gdbm() rb_define_method(rb_cGDBM, "to_a", fgdbm_to_a, 0); rb_define_method(rb_cGDBM, "to_hash", fgdbm_to_hash, 0); - /* flags for gdbm_open() */ + /* flag for #new and #open: open database as a reader */ rb_define_const(rb_cGDBM, "READER", INT2FIX(GDBM_READER|RUBY_GDBM_RW_BIT)); + /* flag for #new and #open: open database as a writer */ rb_define_const(rb_cGDBM, "WRITER", INT2FIX(GDBM_WRITER|RUBY_GDBM_RW_BIT)); + /* flag for #new and #open: open database as a writer; if the database does not exist, create a new one */ rb_define_const(rb_cGDBM, "WRCREAT", INT2FIX(GDBM_WRCREAT|RUBY_GDBM_RW_BIT)); + /* flag for #new and #open: open database as a writer; overwrite any existing databases */ rb_define_const(rb_cGDBM, "NEWDB", INT2FIX(GDBM_NEWDB|RUBY_GDBM_RW_BIT)); + /* flag for #new and #open. this flag is obsolete for gdbm >= 1.8 */ rb_define_const(rb_cGDBM, "FAST", INT2FIX(GDBM_FAST)); /* this flag is obsolete in gdbm 1.8. On gdbm 1.8, fast mode is default behavior. */ /* gdbm version 1.8 specific */ #if defined(GDBM_SYNC) + /* flag for #new and #open. only for gdbm >= 1.8 */ rb_define_const(rb_cGDBM, "SYNC", INT2FIX(GDBM_SYNC)); #endif #if defined(GDBM_NOLOCK) + /* flag for #new and #open */ rb_define_const(rb_cGDBM, "NOLOCK", INT2FIX(GDBM_NOLOCK)); #endif + /* version of the gdbm library*/ rb_define_const(rb_cGDBM, "VERSION", rb_str_new2(gdbm_version)); } |