Michael Tomuschat > Text-SimpleVaddrbook > Text::SimpleVaddrbook

Download:
Text-SimpleVaddrbook-0.01.tar.gz

Dependencies

Annotate this POD

CPAN RT

New  1
Open  0
View/Report Bugs
Module Version: 0.01   Source  

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.

syntax highlighting: