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	* 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