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¶
- •
- "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¶
- •
- "to_string()"
Formats the object according to RFC 2425 and RFC 2426.
- •
- "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.
- •
- "add_to_model($model)"
Given an RDF::Trine::Model, adds triples to the model for this entity.
- •
- "node()"
Returns an RDF::Trine::Node::Blank identifying this entity.
- •
- "entity_order()"
Returns a string along the lines of "Surname;Forename" useful for
sorting a list of entities.
- •
- "profile()"
Returns the entity type - e.g. "VCARD".
- •
- "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.
- •
- "add($line)"
Add a RDF::vCard::Line.
- •
- "get($property)"
Returns a list of RDF::vCard::Line objects for the given property.
e.g.
print "It has an address!\n" if ($vcard->get('ADR'));
- •
- "matches($property, $regexp)"
Checks to see if a property's value matches a regular expression.
print "In London\n" if $vcard->matches(ADR => /London/);
- •
- "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.
- •
- "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.