/ 
Text-SimpleVaddrbook-0.01
River stage zero No dependents
/ Text::SimpleVaddrbook

NAME

Text::SimpleVaddrbook - a package to manage multiple vCard-files

VERSION

Version 0.01

SYNOPSIS

This package provides an API to reading multiple vCard-files. A vCard is an electronic business card. This package has been developed based on rfc2426.

You will find that many applications (KDE Address book, Apple Address book, MS Outlook, Evolution etc) use vCards and can export/import them.

use Text::simpleAdrbook;

my $aBook = SimpleAddrbook->new( '/path/to/addressbook/address.vcf');

while( my $vCard = $aBook->next()) {
   print "Got card for " . $vCard->getFullName() . "\n";
}

FUNCTIONS

new()

my $aBook = Text::simpleAdrbook->new( 'foo.vCard', 'std.vcf');

The method will create an addressbook-object and check for the existence and accessibility of the provided vCards. It will produce a warning, if it can not read a file.

next()

my $vCard = $aBook->next();

This method will read the next vCard-entry in the list of vCard-files. It returns the entry in a vCard-object (see also Text::SimpleVcard). it will return undef when called after the last entry was returned.

rewind()

$aBook->rewind();

This method will rewind the filepointers, so that the next call of the method next() will return the first entry of the first vCard provided. This method is useful to re-read the addressbooks e.g. when they changed

AUTHOR

Michael Tomuschat, <michael.tomuschat at t-online.de>

BUGS

Please report any bugs or feature requests to bug-text-simplevaddrbook at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Text-SimpleVAddrbook. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

You can find documentation for this module with the perldoc command.

perldoc Text::SimpleVaddrbook

You can also look for information at:

COPYRIGHT & LICENSE

Copyright 2008 Michael Tomuschat, all rights reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.