Author image Robert James Clay

NAME

FTN::Address - Process FTN addresses

SYNOPSIS

 my $addr = new FTN::Address('2:464/4077');

 my $address4D = $addr->get();     # 2:464/4077.0

 my $address5D = $addr->getfull(); # 2:464/4077.0@fidonet

 my $fqdn = $addr->fqdn();         # f4077.n464.z2.fidonet.net


 my $addr = empty FTN::Address();

 $addr->assign('2:464/4077');

 my $address4D = $addr->get();     # 2:464/4077.0

DESCRIPTION

FTN::Address

METHODS

new

This method creates FTN::Address object. Takes FTN address as argument. Address can be feed in three addressing variants:

3D, ex.: new FTN::Address '2:464/0' 4D, ex.: new FTN::Address '2:464/4077.1' 5D, ex.: new FTN::Address '2:464/357.0@fidonet'

Default domain for 3D and 4D address is 'fidonet'

empty

This method creates empty FTN::Address object. You cannot use it before assigning a new value.

Takes no parameters.

assign( $address )

This method assign new address to FTN::Address object.

Takes FTN address as argument (like 'new' method).

get()

This method returns qualified 4D address.

Takes no parameters.

getfull()

This method returns qualified 5D address.

Takes no parameters.

fqdn( [ $root_domain [, $level ] ] );

This method returns fully qualified domain name, as described in FSP-1026 Fidonet Technical Standards Comittee document. See this document for details.

Valid values for level are "0, 1, 2, 3, 4, DOM, DO1, DO2, DO3, DO4" Parameters can be omitted, default values will be used. Default root domain is 'net', default level is '0'.

Examples:

 my $addr = new FTN::Address('2:464/4077');
 
 print $addr->fqdn();                    # f4077.n464.z2.fidonet.net
 
 print $addr->fqdn('org');               # f4077.n464.z2.fidonet.org
 
 print $addr->fqdn('railways.dp.ua', 2); # f4077.n464.railways.dp.ua

AUTHORS

Serguei Trouchelle <stro@railways.dp.ua> Robert James Clay <jame@rocasa.us>

COPYRIGHT

Copyright (c) 2005-2006 Serguei Trouchelle. All rights reserved. Copyright (c) 2013 Robert James Clay. All rights reserved.

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