<html xmlns="http://www.w3.org/1999/xhtml"><head></head><body><section><h1>DOM Module: URI Generic</h1><p><anchor-end xmlns="urn:x-suika-fam-cx:markup:suikawiki:0:9:" a0:anchor="1" xmlns:a0="urn:x-suika-fam-cx:markup:suikawiki:0:9:">[1]</anchor-end> The <dfn xml:lang="en">URI Generic Module</dfn> provides a number of
interfaces to extract components of URIs.</p><p><anchor-end xmlns="urn:x-suika-fam-cx:markup:suikawiki:0:9:" a0:anchor="2" xmlns:a0="urn:x-suika-fam-cx:markup:suikawiki:0:9:">[2]</anchor-end> <strong>Feature</strong>.</p><ed xmlns="urn:x-suika-fam-cx:markup:suikawiki:0:10:"><anchor-external xmlns="urn:x-suika-fam-cx:markup:suikawiki:0:9:" a0:resParameter="http://suika.fam.cx/www/2006/feature/uri" xmlns:a0="urn:x-suika-fam-cx:markup:suikawiki:0:9:" a0:resScheme="URI">http://suika.fam.cx/www/2006/feature/uri</anchor-external>, version 4.0</ed><section><h1>The <code class="DOMi" xml:lang="en">URIImplementation</code> interface</h1><p><anchor-end xmlns="urn:x-suika-fam-cx:markup:suikawiki:0:9:" a0:anchor="3" xmlns:a0="urn:x-suika-fam-cx:markup:suikawiki:0:9:">[3]</anchor-end>
The <dfn xml:lang="en"><code class="DOMi" xml:lang="en"><anchor xmlns="urn:x-suika-fam-cx:markup:suikawiki:0:9:">URIImplementation</anchor></code> interface</dfn>
provides factory methods to create 
<code class="DOMi" xml:lang="en"><anchor xmlns="urn:x-suika-fam-cx:markup:suikawiki:0:9:">URIReference</anchor></code> objects.</p><p><anchor-end xmlns="urn:x-suika-fam-cx:markup:suikawiki:0:9:" a0:anchor="4" xmlns:a0="urn:x-suika-fam-cx:markup:suikawiki:0:9:">[4]</anchor-end></p><ed xmlns="urn:x-suika-fam-cx:markup:suikawiki:0:10:">cast</ed><p><anchor-end xmlns="urn:x-suika-fam-cx:markup:suikawiki:0:9:" a0:anchor="5" xmlns:a0="urn:x-suika-fam-cx:markup:suikawiki:0:9:">[5]</anchor-end>
The <dfn xml:lang="en"><code class="DOMm" xml:lang="en"><anchor xmlns="urn:x-suika-fam-cx:markup:suikawiki:0:9:">createURIReference</anchor></code> method</dfn>
returns a <code class="DOMi" xml:lang="en"><anchor xmlns="urn:x-suika-fam-cx:markup:suikawiki:0:9:">URIReference</anchor></code> object.
It creates a <code class="DOMi" xml:lang="en"><anchor xmlns="urn:x-suika-fam-cx:markup:suikawiki:0:9:">URIReference</anchor></code> object
with specified <anchor xmlns="urn:x-suika-fam-cx:markup:suikawiki:0:9:">DOM URI</anchor>.</p><p>This method takes a parameter <code class="DOMp" xml:lang="en"><anchor xmlns="urn:x-suika-fam-cx:markup:suikawiki:0:9:">uri</anchor></code>,
of <code class="DOMi" xml:lang="en"><anchor xmlns="urn:x-suika-fam-cx:markup:suikawiki:0:9:">DOMString</anchor></code>,
which is the <anchor xmlns="urn:x-suika-fam-cx:markup:suikawiki:0:9:">DOM URI</anchor> of the created object.</p><p><anchor-end xmlns="urn:x-suika-fam-cx:markup:suikawiki:0:9:" a0:anchor="6" xmlns:a0="urn:x-suika-fam-cx:markup:suikawiki:0:9:">[6]</anchor-end>
The method <anchor xmlns="urn:x-suika-fam-cx:markup:suikawiki:0:9:"><strong xmlns="http://www.w3.org/1999/xhtml">MUST</strong></anchor> return a new 
<code class="DOMi" xml:lang="en"><anchor xmlns="urn:x-suika-fam-cx:markup:suikawiki:0:9:">URIReference</anchor></code> object whose
<code class="DOMa" xml:lang="en"><anchor xmlns="urn:x-suika-fam-cx:markup:suikawiki:0:9:">uriReference</anchor></code> attribute is
set to <code class="DOMp" xml:lang="en"><anchor xmlns="urn:x-suika-fam-cx:markup:suikawiki:0:9:">uri</anchor></code>.</p><p><anchor-end xmlns="urn:x-suika-fam-cx:markup:suikawiki:0:9:" a0:anchor="7" xmlns:a0="urn:x-suika-fam-cx:markup:suikawiki:0:9:">[7]</anchor-end>
In Perl binding, the following value <anchor xmlns="urn:x-suika-fam-cx:markup:suikawiki:0:9:"><strong xmlns="http://www.w3.org/1999/xhtml">MUST</strong></anchor>
be set to the <code class="DOMa" xml:lang="en"><anchor xmlns="urn:x-suika-fam-cx:markup:suikawiki:0:9:">uriReference</anchor></code> attribute
of the returned object:<pre class="code perl">UNIVERSAL::isa ($uri, 'Message::IF::URIReference')
    ? $uri-&gt;uri_reference
    : ref $uri eq 'SCALAR'
        ? <span>'</span><span>'</span>.$$uri
        : <span>'</span><span>'</span>.$uri</pre><p>... where <code class="perl" xml:lang="en">$<anchor xmlns="urn:x-suika-fam-cx:markup:suikawiki:0:9:">uri</anchor></code> is the value
of the <code class="DOMp" xml:lang="en"><anchor xmlns="urn:x-suika-fam-cx:markup:suikawiki:0:9:">uri</anchor></code> parameter.</p></p></section></section><section><h1>The <code class="DOMi" xml:lang="en">URIReference</code> interface</h1><p>See <code class="DOMi" xml:lang="en"><anchor xmlns="urn:x-suika-fam-cx:markup:suikawiki:0:9:">URIReference</anchor></code></p></section><section><h1>memo</h1></section></body></html>