RDF::Redland::QueryResults(3pm) User Contributed Perl Documentation RDF::Redland::QueryResults(3pm)NAME
RDF::Redland::QueryResults - Redland RDF Syntax Query Results Class
SYNOPSIS
use RDF::Redland;
...
my $query=new RDF::Redland::Query("query string", undef, undef, "sparql");
my $results=$model->query_execute($query);
# or my $results=$query->execute($model);
while(!$results->finished) {
for (my $i=0; $i < $results->bindings_count(); $i++) {
my $name=$results->binding_name($i);
my $value=$results->binding_value($i);
# ... do something with the results
}
$results->next_result;
}
The $results in the example is an object of class RDF::Redland::QueryResults.
DESCRIPTION
This class represents queries of various syntaxes over an RDF::Redland::Model returning a sequence of results that bind variable names to
RDF::Redland::Node values.
CONSTRUCTOR
There are no public constructors.
METHODS
count
Return the number of current results from the query.
finished
Return non-0 if the results have been exhausted.
binding_name INDEX
Get the name of variable binding INDEX in the array of variable names.
binding_names
Get the names all of the variable bindings as an array.
binding_value INDEX
Get the value of the variable binding INDEX in the current query result.
binding_values
Get the values of all of the variable bindings in the current query result.
binding_value_by_name NAME
Get the value of the variable binding NAME in the current query result.
bindings
Get the variable names and values of the current query result as a hash
bindings_count
Return the number of variable bindings.
next_result
Move to the next query result.
as_stream
Return a new RDF::Redland::Stream object representing the query results as an RDF Graph.
to_string [FORMAT-URI [BASE-URI]]
Serialize to a string syntax in format FORMAT-URI using the optional BASE-URI. The default format when none is given is determined by
librdf_query_results_to_string.
is_bindings
Return non-0 if the query results format is variable bindings
is_boolean
Return non-0 if the query results format is a boolean
is_graph
Return non-0 if the query results format is an RDF graph
get_boolean
Get the boolean query result; non-0 is true.
SEE ALSO
RDF::Redland::Query
AUTHOR
Dave Beckett - http://www.dajobe.org/
perl v5.14.2 2011-02-04 RDF::Redland::QueryResults(3pm)
Check Out this Related Man Page
RDF::Redland::Node(3pm) User Contributed Perl Documentation RDF::Redland::Node(3pm)NAME
RDF::Redland::Node - Redland RDF Node (RDF Resource, Property, Literal) Class
SYNOPSIS
use RDF::Redland;
my $node1=new RDF::Redland::Node("Hello, World!");
my $node2=new RDF::Redland::Node($uri); # $uri is an RDF::Redland::URI
my $node3=$node2->clone;
my $node4=new RDF::Redland::URINode("http://example.com/");
my $node5=new RDF::Redland::LiteralNode("Hello, World!");
my $node6=new RDF::Redland::XMLLiteral("<tag>content</tag>");
my $node7=new RDF::Redland::BlankNode("genid1");
# alternate more verbose ways:
my $node4=RDF::Redland::Node->new_from_uri("http://example.com/");
my $node5=RDF::Redland::Node->new_literal("Hello, World!");
my $node6=RDF::Redland::Node->new_xml_literal("<tag>content</tag>");
my $node7=RDF::Redland::Node->new_from_blank_identifier("genid1");
...
print $node4->uri->as_string,"
"; # Using RDF::Redland::URI::as_string
print $node5->literal_value_as_latin1,"
";
DESCRIPTION
This class represents RDF URIs, literals and blank nodes in the RDF graph.
CONSTRUCTORS
new [STRING | URI | NODE]
Create a new URI node, literal node or copy an existing node.
If a literal STRING is given, make a plain literal node. If a the argument is of type URI (perl URI or RDF::Redland::URI), make a
resource node.
Otherwise if the argument is an RDF::Redland::Node NODE, copy it.
new_from_uri URI
Create a new URI node. URI can be either a RDF::Redland::URI object, a perl URI class or a literal string.
An alternative is:
new RDF::Redland::URINode("http://example.org/");
new_literal STRING [DATATYPE [XML_LANGUAGE]]
Create a new literal node for a literal value STRING. Optional datatype URI DATATYPE (RDF::Redland::URI, perl URI or string) and
language (xml:lang attribute) XML_LANGUAGE may also be given.
An alternative is:
new RDF::Redland::LiteralNode("Hello, World!");
new RDF::Redland::LiteralNode("Bonjour monde!", undef, "fr");
new_xml_literal STRING
Create a new XML datatyped literal node for the XML in STRING.
An alternative is:
new RDF::Redland::XMLLiteral("<tag>content</tag>");
new_from_blank_identifier IDENTIFIER
Create a new blank node with blank node identifier IDENTIFIER.
An alternative is:
new RDF::Redland::BlankNode("id");
clone
Copy a RDF::Redland::Node.
METHODS
uri Get the current URI of the node as an RDF::Redland::URI object.
blank_identifier
Get the current blank identifier of the node
type
Get the node type. It is recommended to use the is_resource, is_literal or is_blank methods in preference to this (both simpler and
quicker).
The current list of types that are supported are:
$RDF::Redland::Node::Type_Resource
$RDF::Redland::Node::Type_Literal
$RDF::Redland::Node::Type_Blank
Example:
if ($node->type == $RDF::Redland::Node::Type_Resource) {
print "Node is a resource with URI ", $node->uri->as_string, "
";
} else {
...
}
is_resource
Return true if node is a resource (with a URI)
is_literal
Return true if node is a literal
is_blank
Return true if node is a blank nodeID
literal_value
Get the node literal value string as UTF-8 (when the node is of type $RDF::Redland::Node::Type_Literal)
literal_value_as_latin1
Get the node literal value string converted from UTF-8 to ISO Latin-1 (when the node is of type $RDF::Redland::Node::Type_Literal)
literal_value_language
Get the node literal XML language (when the node is of type $RDF::Redland::Node::Type_Literal) or undef if not present.
literal_value_is_wf_xml
Return non 0 if the literal string is well formed XML (when the node is of type $RDF::Redland::Node::Type_Literal).
literal_datatype
Return the RDF::Redland::URI of the literal datatype or undef if it is not a datatype.
as_string
Return the RDF::Redland::Node formatted as a string (UTF-8 encoded).
equals NODE
Return non zero if this node is equal to NODE
OLDER METHODS
new_from_literal STRING XML_LANGUAGE IS_WF
Create a new RDF::Redland::Node object for a literal value STRING with XML language (xml:lang attribute) XML_LANGUAGE and if content is
well formed XML, when IS_WF is non 0. XML_LANGUAGE is optional can can be set to undef.
This method remains but using new_literal is prefered. Instead, for plain literals use:
$node=new RDF::Redland::Node("blah")
new_from_typed_literal STRING [DATATYPE [XML_LANGUAGE]]
Renamed to new_literal with same arguments.
new_from_uri_string URI_STRING
Create a new RDF::Redland::Node object for a resource with URI URI_STRING. It is equivalent to use the shorter:
$a=new RDF::Redland::Node->new_from_uri($uri_string)
new_from_node NODE
Create a new RDF::Redland::Node object from existing RDF::Redland::Node NODE (copy constructor). It is equivalent to use:
$new_node=$old_node->clone
SEE ALSO
RDF::Redland::Statement
AUTHOR
Dave Beckett - http://www.dajobe.org/
perl v5.14.2 2011-05-09 RDF::Redland::Node(3pm)