Simple BDB wrapper library for bdb
Find a file
2010-02-06 00:41:43 +01:00
lib Wenn kein Element existiert, wird ein Exception geworfen. Dies ist etwas unschoen, also wird diese abgefangen und nil zurueckgegeben. 2010-02-06 00:41:43 +01:00
AUTHOR license added 2010-01-30 15:07:09 +01:00
LICENSE license added 2010-01-30 15:07:09 +01:00
Rakefile Dependency added 2010-01-30 14:59:26 +01:00
README A little bit docu 2010-01-30 15:29:46 +01:00
sbdb.gemspec 0.0.6 2010-02-05 19:16:40 +01:00
VERSION 0.0.6 2010-02-05 19:10:22 +01:00

= Dependencies

== Bdb

Your need first this library:

http://github.com/DenisKnauf/bdb

= Download

via git:

	git clone git://github.com/DenisKnauf/sbdb.git

= Installation

	gem build sbdb.gemspec
	gem install sbdb-*.gem

= Usage

First, open environment and database

	require 'sbdb'
	Dir.mkdir 'newenv'  rescue Errno::EEXIST
	env = SBDB::Env.new 'newenv', SBDB::CREATE
	db = env.open SBDB::Btree, 'newdb.db', 'mynewdb', SBDB::CREATE

It works nearly like a Ruby-Hash:

	db['key'] = 'value'
	db['key']		# => 'value'
	db.to_hash		# => {'key'=>'value'}
	db.map {|k, v| [k, v].join ' => '}		# => ["key => value"]
	db.count		# => 1

SBDB::DB#each uses a SBDB::Cursor:

	cursor = db.cursor
	cursor.each {|k,v| puts "#{k}: ${v}" }

<strong>Don't forget to close everything, you've opened!</strong>

	cursor.close
	db.close
	env.close

But you can use a <em>lambda</em> to ensure to close everything:

	SBDB::Env.new( 'newenv', SBDB::CREATE) do |env|
		env.open SBDB::Btree, 'newdb.db', 'mynewdb', SBDB::CREATE do |db|
			db.to_hash
		end
	end

SBDB::DB#to_hash creates a cursor and close it later.