RDF::v...Entity(3pm)

📦
version 0.012 · 4 versions
, in debian bookworm, ubuntu noble

✨ RDF::vCard::Entity — the whole vibe 💳

okay so bestie, this is RDF::vCard::Entity — it's the class that represents one single vCard. like, one whole contact card, one little entity, just vibing on its own. and ngl it's lowkey built to be a little more flexible than that, because it could potentially be used as the basis for other RFC 2425-based formats too, like iCalendar. it's giving "main character but also willing to share the spotlight." 🎀

🌸 DESCRIPTION 🌸

Every instance of this class corresponds to an individual vCard object. fr fr, that's the whole point of it. but also — she's flexible — she could potentially be used as a basis for other RFC 2425-based formats such as iCalendar. versatile queen. 👑

💅 Constructor

  • new(%options) — returns a brand new RDF::vCard::Entity object. fresh out the box, no cap.

The only option worth worrying about is profile, which sets the profile for the entity. it defaults to VCARD. that's the default. don't overthink it. ✨

Also, RDF::vCard::Entity overloads stringification, so you can literally do this:

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

look at her go 🦋

🧚 Methods

  • to_string() — formats the object according to RFC 2425 and RFC 2426. the classic, the original, the blueprint. 💖
  • to_jcard() — formats the object according to http://microformats.org/wiki/jcard. and heads up: to_jcard(1) will return the same data but without the JSON stringification. same snack, different presentation. 🍓
  • add_to_model($model) — you hand it an RDF::Trine::Model and it adds triples to the model for this entity. she's contributing to the graph. iconic. 🌈
  • node() — returns an RDF::Trine::Node::Blank that identifies this entity. it's her lil name tag. 🎀
  • entity_order() — returns a string along the lines of "Surname;Forename", which is useful for sorting a list of entities. alphabetize your besties, periodt. 💅
  • profile() — returns the entity type — e.g. "VCARD". that's it, that's the tea. ☕
  • lines() — returns an arrayref of RDF::vCard::Line objects, in the order they were originally added. she remembers everything, in order. and just so you know: this excludes the BEGIN:VCARD and END:VCARD lines. those two are not invited to this list. 🙈
  • add($line) — add a RDF::vCard::Line. one line at a time, bestie. 🫶
  • 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. like a vibe check but for data. 👀
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 it's a hook for the benefit of RDF::iCalendar. so she's holding space for her friend. 💜
  • components — lists nested entities within this one. peek inside, see who's living in there. 🔥

👑 SEE ALSO 👑

RDF::vCard.

💖 AUTHOR 💖

Toby Inkster <tobyink@cpan.org>.

Copyright 2011 Toby Inkster

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

and that's the whole page bestie! 🎀 this was RDF::vCard::Entity(3pm) from the User Contributed Perl Documentation, running on perl v5.34.0, dated 2022-06-17. go forth and build your vCards, you absolute legend. slay. ✨💅🦋

📦 where this page comes from