Text::SimpleVaddrbook - a package to manage multiple vCard-files
Version 0.01
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"; }
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.
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.
vCard
Text::SimpleVcard
undef
$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
next()
Michael Tomuschat, <michael.tomuschat at t-online.de>
<michael.tomuschat at t-online.de>
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.
bug-text-simplevaddrbook at rt.cpan.org
You can find documentation for this module with the perldoc command.
perldoc Text::SimpleVaddrbook
You can also look for information at:
RT: CPAN's request tracker
http://rt.cpan.org/NoAuth/Bugs.html?Dist=Text-SimpleVAddrbook
AnnoCPAN: Annotated CPAN documentation
http://annocpan.org/dist/Text-SimpleVaddrbook
CPAN Ratings
http://cpanratings.perl.org/d/Text-SimpleVaddrbook
Search CPAN
http://search.cpan.org/dist/Text-SimpleVaddrbook
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.
To install Text::SimpleVaddrbook, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Text::SimpleVaddrbook
CPAN shell
perl -MCPAN -e shell install Text::SimpleVaddrbook
For more information on module installation, please visit the detailed CPAN module installation guide.