<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<title>Redland RDF Application Framework - Ruby RDoc - Class: Redland::Statement</title>
<link rel="stylesheet" href="../.././rdoc-style.css" type="text/css" media="screen" />
<script type="text/javascript">
// <![CDATA[
function popupCode( url ) {
window.open(url, "Code", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=150,width=400")
}
function toggleCode( id ) {
if ( document.getElementById )
elem = document.getElementById( id );
else if ( document.all )
elem = eval( "document.all." + id );
else
return false;
elemStyle = elem.style;
if ( elemStyle.display != "block" ) {
elemStyle.display = "block"
} else {
elemStyle.display = "none"
}
return true;
}
// Make codeblocks hidden by default
document.writeln( "<style type=\"text/css\">div.method-source-code { display: none }<\/style>" )
// ]]>
</script>
</head>
<body>
<div class="outerBlock">
<div class="outerHeader">
Go to <a href="/" target="_parent">Redland Home</a> -
<a href="/bindings/" target="_parent">Language Bindings Home</a> -
<a href="/docs/ruby.html" target="_parent">Ruby API Home</a>
</div>
<div id="classHeader">
<table class="header-table">
<tr class="top-aligned-row">
<td><strong>Class</strong></td>
<td class="class-name-in-header">Redland::Statement</td>
</tr>
<tr class="top-aligned-row">
<td><strong>In:</strong></td>
<td><a href="../../files/rdf/redland/statement_rb.html">rdf/redland/statement.rb</a><br /></td>
</tr>
<tr class="top-aligned-row">
<td><strong>Parent:</strong></td>
<td>Object</td>
</tr>
</table>
</div>
<!-- banner header -->
<div id="bodyContent">
<div id="contextContent">
<div id="description">
<p><a href="../Redland.html">Redland</a> <a href="Statement.html">Statement</a> (triple class). The main means of manipulating statements is by the <a href="Statement.html#M000140">subject</a>,<a href="Statement.html#M000141">predicate</a>,and <a href="Statement.html#M000142">object</a> properties</p>
<pre>
require 'rdf'
Statement creation from nodes
statement1 = Statement.new(node1,node2,node3)
statement2 = Statement.new(:statement=>statement)
if statement2.resource?
puts "statement2.subject has uri #{statement2.subject.uri}"
</pre></div>
</div>
<div id="method-list">
<h3 class="section-bar">Methods</h3>
<div class="name-list"><a href="#M000147">==</a> <a href="#M000139">create_finalizer</a> <a href="#M000138">new</a> <a href="#M000142">object</a> <a href="#M000144">object=</a> <a href="#M000141">predicate</a> <a href="#M000145">predicate=</a> <a href="#M000140">subject</a> <a href="#M000143">subject=</a> <a href="#M000146">to_s</a> </div>
</div>
</div>
<!-- if includes -->
<div id="includes">
<h3 class="section-bar">Included Modules</h3>
<div id="includes-list"><span class="include-name"><a href="Util.html">Util</a></span></div>
</div>
<div id="section">
<div id="attribute-list">
<h3 class="section-bar">Attributes</h3>
<div class="name-list">
<table>
<tr class="top-aligned-row context-row">
<td class="context-item-name">statement</td>
<td class="context-item-value"> [R] </td>
<td class="context-item-desc">the internal librdf statement</td>
</tr>
</table>
</div>
</div>
<!-- if method_list -->
<div id="methods">
<h3 class="section-bar">Public Class methods</h3>
<div id="method-M000139" class="method-detail"><a name="M000139" id="M000139"></a>
<div class="method-heading"><a href="#M000139" class="method-signature"><span class="method-name">create_finalizer</span><span class="method-args">(statement)</span></a></div>
<div class="method-description">
<p>You shouldn‘t use this. Used internally for cleanup.</p>
<p><a class="source-toggle" href="#" onclick="toggleCode('M000139-source');return false;">[Source]</a></p>
<div class="method-source-code" id="M000139-source">
<pre>
<span class="ruby-comment cmt"># File rdf/redland/statement.rb, line 70</span>
<span class="ruby-keyword kw">def</span> <span class="ruby-constant">Statement</span>.<span class="ruby-identifier">create_finalizer</span>(<span class="ruby-identifier">statement</span>)
<span class="ruby-identifier">proc</span> {<span class="ruby-operator">|</span><span class="ruby-identifier">id</span><span class="ruby-operator">|</span> <span class="ruby-constant">Redland</span><span class="ruby-operator">::</span><span class="ruby-identifier">librdf_free_statement</span>(<span class="ruby-identifier">statement</span>) }
<span class="ruby-keyword kw">end</span>
</pre></div>
</div>
</div>
<div id="method-M000138" class="method-detail"><a name="M000138" id="M000138"></a>
<div class="method-heading"><a href="#M000138" class="method-signature"><span class="method-name">new</span><span class="method-args">(subject=nil,predicate=nil,object=nil,model=nil)</span></a></div>
<div class="method-description">
<p>create a <a href="Statement.html#M000138">new</a> <a href="Statement.html">Statement</a> with <a href="Statement.html#M000140">subject</a>,<a href="Statement.html#M000141">predicate</a>,and <a href="Statement.html#M000142">object</a> the <a href="Statement.html#M000140">subject</a>, <a href="Statement.html#M000141">predicate</a>, and objects can be of class String or <a href="Uri.html">Uri</a>.</p>
<p><a class="source-toggle" href="#" onclick="toggleCode('M000138-source');return false;">[Source]</a></p>
<div class="method-source-code" id="M000138-source">
<pre>
<span class="ruby-comment cmt"># File rdf/redland/statement.rb, line 25</span>
<span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">subject</span>=<span class="ruby-keyword kw">nil</span>,<span class="ruby-identifier">predicate</span>=<span class="ruby-keyword kw">nil</span>,<span class="ruby-identifier">object</span>=<span class="ruby-keyword kw">nil</span>,<span class="ruby-identifier">model</span>=<span class="ruby-keyword kw">nil</span>)
<span class="ruby-ivar">@model</span> = <span class="ruby-identifier">model</span>
<span class="ruby-keyword kw">if</span> <span class="ruby-identifier">subject</span>.<span class="ruby-identifier">class</span> <span class="ruby-operator">==</span> <span class="ruby-constant">Hash</span>
<span class="ruby-keyword kw">if</span> <span class="ruby-identifier">subject</span>.<span class="ruby-identifier">key?</span>(<span class="ruby-identifier">:from_object</span>)
<span class="ruby-ivar">@statement</span> = <span class="ruby-constant">Redland</span>.<span class="ruby-identifier">librdf_new_statement_from_statement</span>(<span class="ruby-identifier">subject</span>[<span class="ruby-identifier">:from_object</span>])
<span class="ruby-ivar">@model</span> = <span class="ruby-identifier">subject</span>[<span class="ruby-identifier">:model</span>]
<span class="ruby-keyword kw">end</span>
<span class="ruby-keyword kw">else</span>
<span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">subject</span>
<span class="ruby-identifier">s</span> = <span class="ruby-keyword kw">nil</span>
<span class="ruby-keyword kw">else</span>
<span class="ruby-keyword kw">if</span> (<span class="ruby-identifier">subject</span>.<span class="ruby-identifier">class</span> <span class="ruby-operator">==</span> <span class="ruby-constant">Uri</span>)<span class="ruby-operator">||</span> (<span class="ruby-identifier">subject</span>.<span class="ruby-identifier">class</span> <span class="ruby-operator">==</span> <span class="ruby-constant">String</span>)
<span class="ruby-identifier">subject</span> = <span class="ruby-constant">Node</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">subject</span>)
<span class="ruby-keyword kw">end</span>
<span class="ruby-identifier">s</span> = <span class="ruby-constant">Redland</span>.<span class="ruby-identifier">librdf_new_node_from_node</span>(<span class="ruby-identifier">subject</span>.<span class="ruby-identifier">node</span>)
<span class="ruby-keyword kw">end</span>
<span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">predicate</span>
<span class="ruby-identifier">p</span> = <span class="ruby-keyword kw">nil</span>
<span class="ruby-keyword kw">else</span>
<span class="ruby-keyword kw">if</span> (<span class="ruby-identifier">predicate</span>.<span class="ruby-identifier">class</span> <span class="ruby-operator">==</span> <span class="ruby-constant">Uri</span>) <span class="ruby-operator">||</span> (<span class="ruby-identifier">predicate</span>.<span class="ruby-identifier">class</span> <span class="ruby-operator">==</span> <span class="ruby-constant">String</span>)
<span class="ruby-identifier">predicate</span> = <span class="ruby-constant">Node</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">predicate</span>)
<span class="ruby-keyword kw">end</span>
<span class="ruby-identifier">p</span> = <span class="ruby-constant">Redland</span>.<span class="ruby-identifier">librdf_new_node_from_node</span>(<span class="ruby-identifier">predicate</span>.<span class="ruby-identifier">node</span>)
<span class="ruby-keyword kw">end</span>
<span class="ruby-keyword kw">unless</span> <span class="ruby-identifier">object</span>
<span class="ruby-identifier">o</span> = <span class="ruby-keyword kw">nil</span>
<span class="ruby-keyword kw">else</span>
<span class="ruby-keyword kw">if</span> (<span class="ruby-identifier">object</span>.<span class="ruby-identifier">class</span> <span class="ruby-operator">==</span> <span class="ruby-constant">Uri</span>) <span class="ruby-operator">||</span> (<span class="ruby-identifier">object</span>.<span class="ruby-identifier">class</span> <span class="ruby-operator">==</span> <span class="ruby-constant">String</span>)
<span class="ruby-identifier">object</span> = <span class="ruby-constant">Node</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">object</span>)
<span class="ruby-keyword kw">end</span>
<span class="ruby-identifier">o</span> = <span class="ruby-constant">Redland</span>.<span class="ruby-identifier">librdf_new_node_from_node</span>(<span class="ruby-identifier">object</span>.<span class="ruby-identifier">node</span>)
<span class="ruby-keyword kw">end</span>
<span class="ruby-ivar">@statement</span> = <span class="ruby-constant">Redland</span>.<span class="ruby-identifier">librdf_new_statement_from_nodes</span>(<span class="ruby-identifier">$world</span>.<span class="ruby-identifier">world</span>,<span class="ruby-identifier">s</span>,<span class="ruby-identifier">p</span>,<span class="ruby-identifier">o</span>)
<span class="ruby-keyword kw">end</span>
<span class="ruby-identifier">raise</span> <span class="ruby-constant">RedlandError</span>.<span class="ruby-identifier">new</span>(<span class="ruby-value str">"Statement construction failed"</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-ivar">@statement</span>
<span class="ruby-constant">ObjectSpace</span>.<span class="ruby-identifier">define_finalizer</span>(<span class="ruby-keyword kw">self</span>,<span class="ruby-constant">Statement</span>.<span class="ruby-identifier">create_finalizer</span>(<span class="ruby-ivar">@statement</span>))
<span class="ruby-keyword kw">end</span>
</pre></div>
</div>
</div>
<h3 class="section-bar">Public Instance methods</h3>
<div id="method-M000147" class="method-detail"><a name="M000147" id="M000147"></a>
<div class="method-heading"><a href="#M000147" class="method-signature"><span class="method-name">==</span><span class="method-args">(other)</span></a></div>
<div class="method-description">
<p>Equivalency. Only works for comparing two Statements</p>
<p><a class="source-toggle" href="#" onclick="toggleCode('M000147-source');return false;">[Source]</a></p>
<div class="method-source-code" id="M000147-source">
<pre>
<span class="ruby-comment cmt"># File rdf/redland/statement.rb, line 140</span>
<span class="ruby-keyword kw">def</span> <span class="ruby-operator">==</span>(<span class="ruby-identifier">other</span>)
<span class="ruby-keyword kw">return</span> (<span class="ruby-constant">Redland</span>.<span class="ruby-identifier">librdf_statement_equals</span>(<span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">statement</span>,<span class="ruby-identifier">other</span>.<span class="ruby-identifier">statement</span>) <span class="ruby-operator">!=</span> <span class="ruby-value">0</span>)
<span class="ruby-keyword kw">end</span>
</pre></div>
</div>
</div>
<div id="method-M000142" class="method-detail"><a name="M000142" id="M000142"></a>
<div class="method-heading"><a href="#M000142" class="method-signature"><span class="method-name">object</span><span class="method-args">()</span></a></div>
<div class="method-description">
<p>return the <a href="Statement.html#M000142">object</a> of the statement triple. The return value is either a <a href="Literal.html">Literal</a> or <a href="Resource.html">Resource</a> depending if <a href="Statement.html#M000142">object</a> returned from the store is literal or not</p>
<p><a class="source-toggle" href="#" onclick="toggleCode('M000142-source');return false;">[Source]</a></p>
<div class="method-source-code" id="M000142-source">
<pre>
<span class="ruby-comment cmt"># File rdf/redland/statement.rb, line 94</span>
<span class="ruby-keyword kw">def</span> <span class="ruby-identifier">object</span>()
<span class="ruby-identifier">object_node</span> = <span class="ruby-constant">Redland</span>.<span class="ruby-identifier">librdf_statement_get_object</span>(<span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">statement</span>)
<span class="ruby-keyword kw">return</span> <span class="ruby-constant">Literal</span>.<span class="ruby-identifier">from_node</span>(<span class="ruby-identifier">object_node</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">is_literal?</span>(<span class="ruby-identifier">object_node</span>)
<span class="ruby-keyword kw">return</span> <span class="ruby-constant">Resource</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">object_node</span>,<span class="ruby-ivar">@model</span>)
<span class="ruby-keyword kw">end</span>
</pre></div>
</div>
</div>
<div id="method-M000144" class="method-detail"><a name="M000144" id="M000144"></a>
<div class="method-heading"><a href="#M000144" class="method-signature"><span class="method-name">object=</span><span class="method-args">(value)</span></a></div>
<div class="method-description">
<p>set the <a href="Statement.html#M000142">object</a> of the statement</p>
<p><a class="source-toggle" href="#" onclick="toggleCode('M000144-source');return false;">[Source]</a></p>
<div class="method-source-code" id="M000144-source">
<pre>
<span class="ruby-comment cmt"># File rdf/redland/statement.rb, line 111</span>
<span class="ruby-keyword kw">def</span> <span class="ruby-identifier">object=</span>(<span class="ruby-identifier">value</span>)
<span class="ruby-keyword kw">if</span> <span class="ruby-identifier">value</span>
<span class="ruby-constant">Redland</span>.<span class="ruby-identifier">librdf_statement_set_object</span>(<span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">statement</span>,
<span class="ruby-constant">Redland</span>.<span class="ruby-identifier">librdf_new_node_from_node</span>(<span class="ruby-identifier">value</span>.<span class="ruby-identifier">node</span>))
<span class="ruby-keyword kw">else</span>
<span class="ruby-constant">Redland</span>.<span class="ruby-identifier">librdf_statement_set_object</span>(<span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">statement</span>, <span class="ruby-keyword kw">nil</span>)
<span class="ruby-keyword kw">end</span>
<span class="ruby-keyword kw">end</span>
</pre></div>
</div>
</div>
<div id="method-M000141" class="method-detail"><a name="M000141" id="M000141"></a>
<div class="method-heading"><a href="#M000141" class="method-signature"><span class="method-name">predicate</span><span class="method-args">()</span></a></div>
<div class="method-description">
<p>return the <a href="Statement.html#M000141">predicate</a> of the statement triple.</p>
<p><a class="source-toggle" href="#" onclick="toggleCode('M000141-source');return false;">[Source]</a></p>
<div class="method-source-code" id="M000141-source">
<pre>
<span class="ruby-comment cmt"># File rdf/redland/statement.rb, line 87</span>
<span class="ruby-keyword kw">def</span> <span class="ruby-identifier">predicate</span>()
<span class="ruby-keyword kw">return</span> <span class="ruby-identifier">wrap_node</span>(<span class="ruby-constant">Redland</span>.<span class="ruby-identifier">librdf_statement_get_predicate</span>(<span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">statement</span>))
<span class="ruby-keyword kw">end</span>
</pre></div>
</div>
</div>
<div id="method-M000145" class="method-detail"><a name="M000145" id="M000145"></a>
<div class="method-heading"><a href="#M000145" class="method-signature"><span class="method-name">predicate=</span><span class="method-args">(value)</span></a></div>
<div class="method-description">
<p>set the <a href="Statement.html#M000141">predicate</a> of the statement</p>
<p><a class="source-toggle" href="#" onclick="toggleCode('M000145-source');return false;">[Source]</a></p>
<div class="method-source-code" id="M000145-source">
<pre>
<span class="ruby-comment cmt"># File rdf/redland/statement.rb, line 121</span>
<span class="ruby-keyword kw">def</span> <span class="ruby-identifier">predicate=</span>(<span class="ruby-identifier">value</span>)
<span class="ruby-keyword kw">if</span> <span class="ruby-identifier">value</span>
<span class="ruby-constant">Redland</span>.<span class="ruby-identifier">librdf_statement_set_predicate</span>(<span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">statement</span>,
<span class="ruby-constant">Redland</span>.<span class="ruby-identifier">librdf_new_node_from_node</span>(<span class="ruby-identifier">value</span>.<span class="ruby-identifier">node</span>))
<span class="ruby-keyword kw">else</span>
<span class="ruby-constant">Redland</span>.<span class="ruby-identifier">librdf_statement_set_predicate</span>(<span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">statement</span>, <span class="ruby-keyword kw">nil</span>)
<span class="ruby-keyword kw">end</span>
<span class="ruby-keyword kw">end</span>
</pre></div>
</div>
</div>
<div id="method-M000140" class="method-detail"><a name="M000140" id="M000140"></a>
<div class="method-heading"><a href="#M000140" class="method-signature"><span class="method-name">subject</span><span class="method-args">()</span></a></div>
<div class="method-description">
<p>return the <a href="Statement.html#M000140">subject</a> of the statement triple. The <a href="Statement.html#M000140">subject</a> is of class <a href="Resource.html">Resource</a></p>
<p><a class="source-toggle" href="#" onclick="toggleCode('M000140-source');return false;">[Source]</a></p>
<div class="method-source-code" id="M000140-source">
<pre>
<span class="ruby-comment cmt"># File rdf/redland/statement.rb, line 82</span>
<span class="ruby-keyword kw">def</span> <span class="ruby-identifier">subject</span>()
<span class="ruby-keyword kw">return</span> <span class="ruby-constant">Resource</span>.<span class="ruby-identifier">new</span>(<span class="ruby-constant">Redland</span>.<span class="ruby-identifier">librdf_statement_get_subject</span>(<span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">statement</span>),<span class="ruby-ivar">@model</span>)
<span class="ruby-keyword kw">end</span>
</pre></div>
</div>
</div>
<div id="method-M000143" class="method-detail"><a name="M000143" id="M000143"></a>
<div class="method-heading"><a href="#M000143" class="method-signature"><span class="method-name">subject=</span><span class="method-args">(value)</span></a></div>
<div class="method-description">
<p>set the <a href="Statement.html#M000140">subject</a> of the statement</p>
<p><a class="source-toggle" href="#" onclick="toggleCode('M000143-source');return false;">[Source]</a></p>
<div class="method-source-code" id="M000143-source">
<pre>
<span class="ruby-comment cmt"># File rdf/redland/statement.rb, line 101</span>
<span class="ruby-keyword kw">def</span> <span class="ruby-identifier">subject=</span>(<span class="ruby-identifier">value</span>)
<span class="ruby-keyword kw">if</span> <span class="ruby-identifier">value</span>
<span class="ruby-constant">Redland</span>.<span class="ruby-identifier">librdf_statement_set_subject</span>(<span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">statement</span>,
<span class="ruby-constant">Redland</span>.<span class="ruby-identifier">librdf_new_node_from_node</span>(<span class="ruby-identifier">value</span>.<span class="ruby-identifier">node</span>))
<span class="ruby-keyword kw">else</span>
<span class="ruby-constant">Redland</span>.<span class="ruby-identifier">librdf_statement_set_subject</span>(<span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">statement</span>, <span class="ruby-keyword kw">nil</span>)
<span class="ruby-keyword kw">end</span>
<span class="ruby-keyword kw">end</span>
</pre></div>
</div>
</div>
<div id="method-M000146" class="method-detail"><a name="M000146" id="M000146"></a>
<div class="method-heading"><a href="#M000146" class="method-signature"><span class="method-name">to_s</span><span class="method-args">()</span></a></div>
<div class="method-description">
<p>Convert this <a href="Statement.html">Statement</a> to a string</p>
<p><a class="source-toggle" href="#" onclick="toggleCode('M000146-source');return false;">[Source]</a></p>
<div class="method-source-code" id="M000146-source">
<pre>
<span class="ruby-comment cmt"># File rdf/redland/statement.rb, line 131</span>
<span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_s</span>()
<span class="ruby-keyword kw">unless</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">statement</span>
<span class="ruby-identifier">raise</span> <span class="ruby-constant">RedlandError</span>.<span class="ruby-identifier">new</span>(<span class="ruby-value str">"Statement is invalid"</span>)
<span class="ruby-keyword kw">else</span>
<span class="ruby-keyword kw">return</span> <span class="ruby-constant">Redland</span>.<span class="ruby-identifier">librdf_statement_to_string</span>(<span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">statement</span>)
<span class="ruby-keyword kw">end</span>
<span class="ruby-keyword kw">end</span>
</pre></div>
</div>
</div>
</div>
</div>
<hr />
<div class="outerHeader">
Go to <a href="/" target="_parent">Redland Home</a> -
<a href="/bindings/" target="_parent">Language Bindings Home</a> -
<a href="/docs/ruby.html" target="_parent">Ruby API Home</a>
</div>
<p>(C) Copyright 2004-2011 <a href="http://www.dajobe.org/" target="_parent">Dave Beckett</a>, (C) Copyright 2004-2005 <a href="http://www.bristol.ac.uk/" target="_parent">University of Bristol</a></p>
</div> <!-- end outerBlock -->
</body>
</html>