ids/8/542.txt

* DOM Module: URI Generic

[1] The [DFN@en[URI Generic Module]] provides a number of
interfaces to extract components of URIs.

[2] '''Feature'''.

@@ <http://suika.fam.cx/www/2006/feature/uri>, version 4.0

** The [CODE(DOMi)@en[URIImplementation]] interface

[3]
The [DFN@en[[CODE(DOMi)@en[[[URIImplementation]]]] interface]]
provides factory methods to create 
[CODE(DOMi)@en[[[URIReference]]]] objects.

[4]

@@ cast

[5]
The [DFN@en[[CODE(DOMm)@en[[[createURIReference]]]] method]]
returns a [CODE(DOMi)@en[[[URIReference]]]] object.
It creates a [CODE(DOMi)@en[[[URIReference]]]] object
with specified [[DOM URI]].

This method takes a parameter [CODE(DOMp)@en[[[uri]]]],
of [CODE(DOMi)@en[[[DOMString]]]],
which is the [[DOM URI]] of the created object.

[6]
The method [['''MUST''']] return a new 
[CODE(DOMi)@en[[[URIReference]]]] object whose
[CODE(DOMa)@en[[[uriReference]]]] attribute is
set to [CODE(DOMp)@en[[[uri]]]].

[7]
In Perl binding, the following value [['''MUST''']]
be set to the [CODE(DOMa)@en[[[uriReference]]]] attribute
of the returned object:
[PRE(code perl)[
UNIVERSAL::isa ($uri, 'Message::IF::URIReference')
    ? $uri->uri_reference
    : ref $uri eq 'SCALAR'
        ? [SPAN[']][SPAN[']].$$uri
        : [SPAN[']][SPAN[']].$uri
]PRE]
... where [CODE(perl)@en[$[[uri]]]] is the value
of the [CODE(DOMp)@en[[[uri]]]] parameter.

* The [CODE(DOMi)@en[URIReference]] interface

See [CODE(DOMi)@en[[[URIReference]]]]

* memo
1	wakaba	1.1	* DOM Module: URI Generic
2
3			[1] The [DFN@en[URI Generic Module]] provides a number of
4			interfaces to extract components of URIs.
5
6			[2] '''Feature'''.
7
8			@@ <http://suika.fam.cx/www/2006/feature/uri>, version 4.0
9
10			** The [CODE(DOMi)@en[URIImplementation]] interface
11
12			[3]
13			The [DFN@en[[CODE(DOMi)@en[[[URIImplementation]]]] interface]]
14			provides factory methods to create
15			[CODE(DOMi)@en[[[URIReference]]]] objects.
16
17			[4]
18
19			@@ cast
20
21			[5]
22			The [DFN@en[[CODE(DOMm)@en[[[createURIReference]]]] method]]
23			returns a [CODE(DOMi)@en[[[URIReference]]]] object.
24			It creates a [CODE(DOMi)@en[[[URIReference]]]] object
25			with specified [[DOM URI]].
26
27			This method takes a parameter [CODE(DOMp)@en[[[uri]]]],
28			of [CODE(DOMi)@en[[[DOMString]]]],
29			which is the [[DOM URI]] of the created object.
30
31			[6]
32			The method [['''MUST''']] return a new
33			[CODE(DOMi)@en[[[URIReference]]]] object whose
34			[CODE(DOMa)@en[[[uriReference]]]] attribute is
35			set to [CODE(DOMp)@en[[[uri]]]].
36
37			[7]
38			In Perl binding, the following value [['''MUST''']]
39			be set to the [CODE(DOMa)@en[[[uriReference]]]] attribute
40			of the returned object:
41			[PRE(code perl)[
42			UNIVERSAL::isa ($uri, 'Message::IF::URIReference')
43			? $uri->uri_reference
44			: ref $uri eq 'SCALAR'
45			? [SPAN[']][SPAN[']].$$uri
46			: [SPAN[']][SPAN[']].$uri
47			]PRE]
48			... where [CODE(perl)@en[$[[uri]]]] is the value
49			of the [CODE(DOMp)@en[[[uri]]]] parameter.
50
51			* The [CODE(DOMi)@en[URIReference]] interface
52
53			See [CODE(DOMi)@en[[[URIReference]]]]
54
55			* memo