rdf::vcard::entity(3pm) [debian man page]

RDF::vCard::Entity(3pm) 				User Contributed Perl Documentation				   RDF::vCard::Entity(3pm)

NAME

       RDF::vCard::Entity - represents a single vCard

DESCRIPTION

       Instances of this class correspond to individual vCard objects, though it could potentially be used as basis for other RFC 2425-based
       formats such as iCalendar.

   Constructor
       o   "new(%options)"

	   Returns a new RDF::vCard::Entity object.

	   The only option worth worrying about is profile which sets the profile for the entity. This defaults to "VCARD".

	   RDF::vCard::Entity overloads stringification, so you can do the following:

	     my $vcard = RDF::vCard::Entity->new;
	     print $vcard if $vcard =~ /VCARD/i;

   Methods
       o   "to_string()"

	   Formats the object according to RFC 2425 and RFC 2426.

       o   "to_jcard()"

	   Formats the object according to <http://microformats.org/wiki/jcard>.

	   to_jcard(1) will return the same data but without the JSON stringification.

       o   "add_to_model($model)"

	   Given an RDF::Trine::Model, adds triples to the model for this entity.

       o   "node()"

	   Returns an RDF::Trine::Node::Blank identifying this entity.

       o   "entity_order()"

	   Returns a string along the lines of "Surname;Forename" useful for sorting a list of entities.

       o   "profile()"

	   Returns the entity type - e.g. "VCARD".

       o   "lines()"

	   Returns an arrayref of RDF::vCard::Line objects in the order they were originally added.

	   This excludes the "BEGIN:VCARD" and "END:VCARD" lines.

       o   "add($line)"

	   Add a RDF::vCard::Line.

       o   "get($property)"

	   Returns a list of RDF::vCard::Line objects for the given property.

	   e.g.

	     print "It has an address!
" if ($vcard->get('ADR'));

       o   "matches($property, $regexp)"

	   Checks to see if a property's value matches a regular expression.

	     print "In London
" if $vcard->matches(ADR => /London/);

       o   "add_component($thing)"

	   Adds a nested entity within this one. This method is unused for vCard, but is a hook for the benefit of RDF::iCalendar.

       o   "components"

	   Lists nested entities within this one.

SEE ALSO

       RDF::vCard.

AUTHOR

       Toby Inkster <tobyink@cpan.org>.

COPYRIGHT

       Copyright 2011 Toby Inkster

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

perl v5.14.2							    2012-06-23						   RDF::vCard::Entity(3pm)

Check Out this Related Man Page

RDF::vCard(3pm) 					User Contributed Perl Documentation					   RDF::vCard(3pm)

NAME

       RDF::vCard - convert between RDF and vCard

SYNOPSIS

	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 '', $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 => 'RDFXML');

DESCRIPTION

       This module doesn't do anything itself; it just loads RDF::vCard::Exporter and RDF::vCard::Importer for you.

   RDF::vCard::Exporter
       RDF::vCard::Exporter takes some RDF using the W3C's vCard vocabulary, and outputs RDF::vCard::Entity objects.

   RDF::vCard::Importer
       RDF::vCard::Importer does the reverse.

   RDF::vCard::Entity
       An RDF::vCard::Entity objects is an individual vCard. It overloads stringification, so just treat it like a string.

   RDF::vCard::Entity::WithXmlSupport
       RDF::vCard::Entity::WithXmlSupport is a subclass of RDF::vCard::Entity, with a "to_xml" method. It requires XML::LibXML to be installed and
       working. The importer and exporter will try to create these if possible.

   RDF::vCard::Line
       RDF::vCard::Line is internal fu that you probably don't want to touch.

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.

       Please report any other bugs to https://rt.cpan.org/Public/Dist/Display.html?Name=RDF-vCard
       <https://rt.cpan.org/Public/Dist/Display.html?Name=RDF-vCard>.

SEE ALSO

       http://www.w3.org/Submission/vcard-rdf/ <http://www.w3.org/Submission/vcard-rdf/>.

       <http://perlrdf.org/>.

       RDF::vCard::Babelfish.

AUTHOR

       Toby Inkster <tobyink@cpan.org>.

COPYRIGHT

       Copyright 2011 Toby Inkster

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

perl v5.14.2							    2012-06-23							   RDF::vCard(3pm)

Linux and UNIX Man Pages

rdf::vcard::entity(3pm) [debian man page]

Check Out this Related Man Page