NAME

XML::XBEL::Folder - OOP for reading/writing XBEL folders.

SYNOPSIS

 use XML::XBEL::Folder;

DESCRIPTION

OOP for reading/writing XBEL folders.

PACKAGE METHODS

PACKAGE->new(\%args)

Valid arguments are :

title
String.
desc
String.
id
String.
added
String.
folded
yes (default) or no.
info
Hash ref, with the following key/value pairs :

•: owner
Array ref.

Returns a XML::XBEL::Folder object.

OBJECT METHODS

$obj->title($title)

Get/set the title for an XBEL folder.

Returns a string when called with no arguments; otherwise returns true or false.

$obj->desc($description)

Get/set the description for an XBEL folder.

Returns a string when called with no arguments; otherwise returns true or false.

$obj->info(\%args)

Get/set the metadata for an XBEL document.

Valid args are :

•: owner
Array reference

Returns an array reference when called with no arguments; otherwise returns true or false.

$obj->id($id)

Get/set the id attribute for an XBEL folder.

$obj->added($datetime)

Get/set the creation datetime for an XBEL folder.

Returns a string when called with no arguments; otherwise returns true or false.

$obj->folded($bool)

Get/set the folded state for an XBEL folder.

Returns a string when called with no arguments; otherwise returns true or false.

$obj->bookmarks($recursive)

Returns a list of child XML::XBEL::Bookmark objects.

Where $recursive is a boolean indicating whether to return all the bookmarks in an XBEL folder or only its immediate children.

$obj->folders($recursive)

Returns a list of child XML::XBEL::Folder objects.

Where $recursive is a boolean indicating whether to return all the folders in an XBEL folder or only its immediate children.

$obj->aliases($recursive)

Returns a list of child XML::XBEL::Alias objects.

Where $recursive is a boolean indicating whether to return all the aliases in an XBEL folder or only its immediate children.

$obj->add_bookmark(XML::XBEL::Bookmark)

Add a new bookmark to an XBEL folder.

If passed a hash ref, valid arguments are the same as those defined for the XML::XBEL::Bookmark object constructor.

$obj->add_folder(XML::XBEL::Folder)

Add a new folder to an XBEL folder.

If passed a hash ref, valid arguments are the same as those defined for the XML::XBEL::Folder object constructor.

$obj->add_alias(XML::XBEL::Alias)

Add a new alias to an XBEL folder.

If passed a hash ref, valid arguments are the same as those defined for the XML::XBEL::Alias object constructor.

$obj->delete()

Delete an XBEL folder.

$obj->toString($format)

$obj->toFile($filename,$format)

$obj->toFH(\*$fh,$format)

VERSION

$Revision: 1.5 $

DATE

$Date: 2004/06/24 02:15:15 $

AUTHOR

Aaron Straup Cope <ascope@cpan.org>

LICENSE

This is free software, you may use it and distribute it under the same terms as Perl itself.