NAME

Lux::IO - A Perl Interface to Lux IO

SYNOPSIS

  use Lux::IO;
  use Lux::IO::Btree;

  my $bt = Lux::IO::Btree->new(Lux::IO::CLUSTER);
  $bt->open('test', Lux::DB_CREAT);
  $bt->put('key', 'value', Lux::IO::OVERWRITE); #=> true
  $bt->get('key');                              #=> 'value'
  $bt->del('key');                              #=> true
  $bt->get('key');                              #-> false
  $bt->close;

DESCRIPTION

Lux IO is a yet another database manager. Lux::IO provides a Perl interface to it. You must note that it supports only BTree-based database so far, though Lux IO supports also hash-based database.

METHODS

new ( $index_type )

  my $bt = Lux::IO::Btree->new(Lux::IO::CLUSTER);

Creates and returns a new Lux::IO::Btree object. $insert_type can be one of the types below:

over 4

* Lux::IO::CLUSTER

* Lux::IO::NONCLUSTER

back

open ( $filename, $oflags )

  $bt->open($filename, Lux::DB_CREAT);

Opens a database specified by $filename. $oflags can be one of or a combination of the flags below:

over 4

* Lux::DB_RDONLY

* Lux::DB_RDWR

* Lux::DB_CREAT

* Lux::DB_TRUNC

back

close ()

  $bt->close();

Closes the database.

get ( $key )

  $bt->get($key);

Retrieves a value which is correspondent to the $key from the database.

put ( $key, $value, $insert_mode )

  $bt->put($key, $value, Lux::IO::OVERWRITE);

Stores the key-value pair into the database. $insert_mode can be one of the modes below:

over 4

* Lux::IO::OVERWRITE

* Lux::IO::NOOVERWRITE

* Lux::IO::APPEND

back

del ( $key )

  $bt->del($key);

Deletes the value which is correspondent to the $key.

SEE ALSO

• Lux IO

  http://luxio.sourceforge.net/

AUTHOR

• Kentaro Kuribayashi <kentaro@cpan.org>

ACKNOWLEDGMENT

• Tokuhiro Matsuno for much improvement of the codes.

COPYRIGHT AND LICENSE

Copyright (c) Kentaro Kuribayashi <kentaro@cpan.org>

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.8 or, at your option, any later version of Perl 5 you may have available.