Data::Hive - convenient access to hierarchical data
Version 0.052
use Data::Hive;
my $hive = Data::Hive->NEW(\%arg);
print $hive->foo->bar->baz;
$hive->foo->bar->quux->SET(17);
Several methods are thin wrappers around required modules in Data::Hive::Store subclasses. These methods all basically call a method on the store with the same (but lowercased) name and pass it the hive's path:
arguments:
A Data::Hive::Store object, or an object that implements its get, set, and name methods.
Class to instantiate $store from. The classname will have 'Data::Hive::Store::' prepended; to avoid this, prefix it with a '+' ('+My::Store'). Mutually exclusive with the store option.
Arguments to instantiate $store with. Mutually exclusive with the store option.
Retrieve the value represented by this object's path from the store.
Soley for Perl 5.6.1 compatability, where returning undef from overloaded numification/stringification can cause a segfault.
$hive->some->path->SET($val);
Set this path's value in the store.
Returns a textual representation of this hive's path. Store-dependent.
$hive->ITEM('foo');
Return a child of this hive. Useful for path segments whose names are not valid Perl method names.
if ($hive->foo->bar->EXISTS) { ... }
Return true if the value represented by this hive exists in the store.
$hive->foo->bar->DELETE;
Delete the value represented by this hive from the store. Returns the previous value, if any.
Throw an exception if the given store can't delete items for some reason.
Hans Dieter Pearcey, <hdp at cpan.org>
Please report any bugs or feature requests to bug-data-hive at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Data-Hive. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.
You can find documentation for this module with the perldoc command.
perldoc Data::Hive
You can also look for information at:
Copyright 2006 Hans Dieter Pearcey, all rights reserved.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
