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

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

NAME

       RDF::vCard::Line - represents a line within a vCard

DESCRIPTION

       Instances of this class correspond to lines within vCards, though they could potentially be used as basis for other RFC 2425-based formats
       such as iCalendar.

   Constructor
       o   "new(%options)"

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

	   The only options worth worrying about are: property (case-insensitive property name), value (arrayref or single string value),
	   type_parameters (hashref of property-related parameters).

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

	     my $line = RDF::vCard::Line->new(
	       property        => 'email',
	       value	       => 'joe@example.net',
	       type_parameters => { type=>['PREF','INTERNET'] },
	       );
	     print "$line
" if $line =~ /internet/i;

   Methods
       o   "to_string()"

	   Formats the line according to RFC 2425 and RFC 2426.

       o   "add_to_model($model, $node)"

	   Given an RDF::Trine::Model and an RDF::Trine::Node representing the entity (i.e. vcard) that this line belongs to, adds triples to the
	   model for this line.

       o   "property()"

	   Returns the line's property - e.g. "EMAIL".

       o   "property_node()"

	   Returns the line's property as an RDF::Trine::Node that can be used as an RDF predicate. Returns undef if a sensible URI cannot be
	   found.

       o   "property_order()"

	   Returns a string which can be used to sort a list of lines into a sensible order.

       o   "value()"

	   Returns an arrayref for the value. Each item in the arrayref could be a plain scalar, or an arrayref of scalars. For example the
	   arrayref representing this name:

	     N:Smith;John;Edward,James

	   which is the vCard representation of somebody with surname Smith, given name John and additional names (middle names) Edward and James,
	   might be represented with the following "value" arrayref:

	     [
	       'Smith',
	       'John',
	       ['Edward', 'James'],
	     ]

	   or maybe:

	     [
	       ['Smith'],
	       'John',
	       ['Edward', 'James'],
	     ]

	   That's why it's sometimes useful to have a normalised version of it...

       o   "nvalue()"

	   Returns a normalised version of the arrayref for the value. It will always be an arrayref of arrayrefs. For example:

	     [
	       ['Smith'],
	       ['John'],
	       ['Edward', 'James'],
	     ]

       o   "value_node()"

	   Returns the line's value as an RDF::Trine::Node that can be used as an RDF object. For some complex properties (e.g. ADR, GEO, ORG, N,
	   etc) the result is not especially useful.

       o   "value_to_string()"

	   Formats the line value according to RFC 2425 and RFC 2426.

       o   "type_parameters()"

	   Returns the type_parameters hashref. Here be monsters (kinda).

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::Line(3pm)

Check Out this Related Man Page

RDF::Trine::Graph(3pm)					User Contributed Perl Documentation				    RDF::Trine::Graph(3pm)

NAME

       RDF::Trine::Graph - Materialized RDF Graphs for testing isomorphism

VERSION

       This document describes RDF::Trine::Graph version 1.000

SYNOPSIS

	 use RDF::Trine::Graph;
	 my $a = RDF::Trine::Graph->new( $model_a );
	 my $b = RDF::Trine::Graph->new( $model_b );
	 print "graphs are " . ($a->equals( $b ) ? "the same" : "different");

DESCRIPTION

       RDF::Trine::Graph provdes a mechanism for testing graph isomorphism based on graph triples from either a RDF::Trine::Model or a
       RDF::Trine::Iterator.  Isomorphism testing requires materializing all of a graph's triples in memory, and so should be used carefully in
       situations with large graphs.

METHODS

       "new ( $model )"
       "new ( $iterator )"
	   Returns a new graph from the given RDF::Trine::Model or RDF::Trine::Iterator::Graph object.

       "equals ( $graph )"
	   Returns true if the invocant and $graph represent two equal RDF graphs (e.g.  there exists a bijection between the RDF statements of
	   the invocant and $graph).

       "is_subgraph_of ( $graph )"
	   Returns true if the invocant is a subgraph of $graph. (i.e. there exists an injection of RDF statements from the invocant to $graph.)

       "injection_map ( $graph )"
	   If the invocant is a subgraph of $graph, returns a mapping of blank node identifiers from the invocant graph to $graph as a hashref.
	   Otherwise returns false. The solution is not always unique; where there exist multiple solutions, the solution returned is arbitrary.

       "split_blank_statements"
	   Returns two array refs, containing triples with blank nodes and triples without any blank nodes, respectively.

       "get_statements"
	   Returns a RDF::Trine::Iterator::Graph object for the statements in this graph.

       "error"
	   Returns an error string explaining the last failed "equal" call.

BUGS

       Please report any bugs or feature requests to through the GitHub web interface at <https://github.com/kasei/perlrdf/issues>.

AUTHOR

       Gregory Todd Williams  "<gwilliams@cpan.org>"

COPYRIGHT

       Copyright (c) 2006-2012 Gregory Todd Williams. This program is free software; you can redistribute it and/or modify it under the same terms
       as Perl itself.

perl v5.14.2							    2012-06-29						    RDF::Trine::Graph(3pm)

Linux and UNIX Man Pages

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

Check Out this Related Man Page