.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "RDF::vCard 3pm"
.TH RDF::vCard 3pm 2024-03-07 "perl v5.38.2" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH NAME
RDF::vCard \- convert between RDF and vCard
.SH SYNOPSIS
.IX Header "SYNOPSIS"
.Vb 2
\& use RDF::vCard;
\& use RDF::TrineShortcuts qw(rdf_string);
\& 
\& my $input    = "http://example.com/contact\-data.rdf";
\& my $exporter = RDF::vCard::Exporter\->new;
\& 
\& my $data     = join \*(Aq\*(Aq, $exporter\->export_cards($input);
\& print $data; # vCard 3.0 data
\& 
\& my $importer = RDF::vCard::Importer\->new;
\& $importer\->import_string($data);
\& print rdf_string($importer\->model => \*(AqRDFXML\*(Aq);
.Ve
.SH DESCRIPTION
.IX Header "DESCRIPTION"
This module doesn't do anything itself; it just loads RDF::vCard::Exporter 
and RDF::vCard::Importer for you.
.SS RDF::vCard::Exporter
.IX Subsection "RDF::vCard::Exporter"
RDF::vCard::Exporter takes some RDF using the W3C's vCard vocabulary,
and outputs RDF::vCard::Entity objects.
.SS RDF::vCard::Importer
.IX Subsection "RDF::vCard::Importer"
RDF::vCard::Importer does the reverse.
.SS RDF::vCard::Entity
.IX Subsection "RDF::vCard::Entity"
An RDF::vCard::Entity objects is an individual vCard. It overloads
stringification, so just treat it like a string.
.SS RDF::vCard::Entity::WithXmlSupport
.IX Subsection "RDF::vCard::Entity::WithXmlSupport"
RDF::vCard::Entity::WithXmlSupport is a subclass of RDF::vCard::Entity,
with a \f(CW\*(C`to_xml\*(C'\fR method. It requires XML::LibXML to be installed and
working. The importer and exporter will try to create these if possible.
.SS RDF::vCard::Line
.IX Subsection "RDF::vCard::Line"
RDF::vCard::Line is internal fu that you probably don't want to touch.
.SH BUGS
.IX Header "BUGS"
If your RDF asserts that Alice is Bob's AGENT and Bob is Alice's AGENT, then
RDF::vCard::Export will eat your face. Don't do it.
.PP
Please report any other bugs to
<https://rt.cpan.org/Public/Dist/Display.html?Name=RDF\-vCard>.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
<http://www.w3.org/Submission/vcard\-rdf/>.
.PP
<http://perlrdf.org/>.
.PP
RDF::vCard::Babelfish.
.SH AUTHOR
.IX Header "AUTHOR"
Toby Inkster <tobyink@cpan.org>.
.SH COPYRIGHT
.IX Header "COPYRIGHT"
Copyright 2011 Toby Inkster
.PP
This library is free software; you can redistribute it and/or modify it
under the same terms as Perl itself.