VERSION

SYNOPSIS

use URI::NamespaceMap;
my $map = URI::NamespaceMap->new( { xsd => 'http://www.w3.org/2001/XMLSchema#' } );
$map->namespace_uri('xsd')->as_string;
my $foaf = URI::Namespace->new( 'http://xmlns.com/foaf/0.1/' );
$map->add_mapping(foaf => $foaf);
$map->add_mapping(rdf => 'http://www.w3.org/1999/02/22-rdf-syntax-ns#' );
$map->list_prefixes; # ( 'foaf', 'rdf', 'xsd' )
$map->foaf; # Returns URI::Namespace object

DESCRIPTION

METHODS

"new ( [ \%namespaces | @prefixes | @uris ] )"

Returns a new namespace map object. You can pass a hash reference with mappings from local names to namespace URIs (given as string or RDF::Trine::Node::Resource) or namespaces_map with a hashref. You may also pass an arrayref containing just prefixes and/or namespace URIs, and the module will try to guess the missing part. To use this feature, you need RDF::NS::Curated, RDF::NS, XML::CommonNS or RDF::Prefixes, or preferably all of them.

"add_mapping ( $name => $uri )"

Adds a new namespace to the map. The namespace URI can be passed as string or a URI::Namespace object.

"remove_mapping ( $name )"

Removes a namespace from the map given a prefix.

"namespace_uri ( $name )"

Returns the URI::Namespace object (if any) associated with the given prefix.

$name

This module creates a method for all the prefixes, so you can say e.g.

  $map->foaf

and get a URI::Namespace object for the FOAF namespace. Since URI::Namespace does the same for local names, you can then say e.g.

  $map->foaf->name

to get a full URI.

"list_namespaces"

Returns an array of URI::Namespace objects with all the namespaces.

"list_prefixes"

Returns an array of prefixes.

"uri ( $prefixed_name )"

Returns a URI for an abbreviated string such as 'foaf:Person'.

prefix_for "uri ($uri)"

Returns the associated prefix (or potentially multiple prefixes, when called in list context) for the given URI.

abbreviate "uri ($uri)"

Complement to ``namespace_uri''. Returns the given URI in "foo:bar" format or "undef" if it wasn't matched, therefore the idiom

    my $str = $nsmap->abbreviate($uri_node) || $uri->as_string;

may be useful for certain serialization tasks.

AUTHORS

CONTRIBUTORS

SUPPORT

    perldoc URI::NamespaceMap

COPYRIGHT & LICENSE

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.