Thiago Berlitz Rondon > URI-tel-0.03 > URI::tel

Download:
URI-tel-0.03.tar.gz

Dependencies

Annotate this POD

CPAN RT

Open  0
View/Report Bugs
Module Version: 0.02   Source  

NAME ^

URI::tel - The tel URI for Telephone Numbers (RFC 3966)

SYNOPSIS ^

    use URI::tel;

    my $uri_client = new URI::tel;

    $uri_client->telephone_uri('tel:+1-201-555-0123');
    print $uri_client->telephone_subscriber, "\n";

    $uri_client->telephone_uri('tel:7042;phone-context=example.com');
    print $uri_client->context, "\n";

    # or

    use URI;
    use URI::tel;

    my $uri = URI->new('tel:+1-201-555-0123')

DESCRIPTION ^

The termination point of the "tel" URI telephone number is not restricted. It can be in the public telephone network, a private telephone network, or the Internet. It can be fixed or wireless and address a fixed wired, mobile, or nomadic terminal. The terminal addressed can support any electronic communication service (ECS), including voice, data, and fax. The URI can refer to resources identified by a telephone number, including but not limited to originators or targets of a telephone call.

The "tel" URI is a globally unique identifier ("name") only; it does not describe the steps necessary to reach a particular number and does not imply dialling semantics. Furthermore, it does not refer to a specific physical device, only to a telephone number.

Changes Since RFC 2806

The specification is syntactically backwards-compatible with the "tel" URI defined in RFC 2806 [RFC2806] but has been completely rewritten. This document more clearly distinguishes telephone numbers as identifiers of network termination points from dial strings and removes the latter from the purview of "tel" URIs.

Compared to RFC 2806, references to carrier selection, dial context, fax and modem URIs, post-dial strings, and pause characters have been removed. The URI syntax now conforms to RFC 2396 [RFC2396].

ATTRIBUTES ^

telephone_uri

isdn_subaddress

extension

context

METHODS ^

telephone_subscriber

tel_cmp

Compare two numbers, according to RFC 3866:

- Both must be either local or global numbers.

- The 'global-number-digits' and the 'local-number-digits' must be equal, after removing all visual separators.

CREDITS ^

Douglas Christopher Wilson

AUTHOR ^

Thiago Rondon <thiago@aware.com.br>

http://www.aware.com.br/

LICENSE ^

Perl License.

syntax highlighting: