Blame lib/Net/DNS/RR/GPOS.pm

Packit Service f6e53a
package Net::DNS::RR::GPOS;
Packit Service f6e53a
Packit Service f6e53a
#
Packit Service f6e53a
# $Id: GPOS.pm 1528 2017-01-18 21:44:58Z willem $
Packit Service f6e53a
#
Packit Service f6e53a
our $VERSION = (qw$LastChangedRevision: 1528 $)[1];
Packit Service f6e53a
Packit Service f6e53a
Packit Service f6e53a
use strict;
Packit Service f6e53a
use warnings;
Packit Service f6e53a
use base qw(Net::DNS::RR);
Packit Service f6e53a
Packit Service f6e53a
=head1 NAME
Packit Service f6e53a
Packit Service f6e53a
Net::DNS::RR::GPOS - DNS GPOS resource record
Packit Service f6e53a
Packit Service f6e53a
=cut
Packit Service f6e53a
Packit Service f6e53a
Packit Service f6e53a
use integer;
Packit Service f6e53a
Packit Service f6e53a
use Carp;
Packit Service f6e53a
use Net::DNS::Text;
Packit Service f6e53a
Packit Service f6e53a
Packit Service f6e53a
sub _decode_rdata {			## decode rdata from wire-format octet string
Packit Service f6e53a
	my $self = shift;
Packit Service f6e53a
	my ( $data, $offset ) = @_;
Packit Service f6e53a
Packit Service f6e53a
	my $limit = $offset + $self->{rdlength};
Packit Service f6e53a
	( $self->{latitude},  $offset ) = decode Net::DNS::Text( $data, $offset ) if $offset < $limit;
Packit Service f6e53a
	( $self->{longitude}, $offset ) = decode Net::DNS::Text( $data, $offset ) if $offset < $limit;
Packit Service f6e53a
	( $self->{altitude},  $offset ) = decode Net::DNS::Text( $data, $offset ) if $offset < $limit;
Packit Service f6e53a
	croak('corrupt GPOS data') unless $offset == $limit;	# more or less FUBAR
Packit Service f6e53a
}
Packit Service f6e53a
Packit Service f6e53a
Packit Service f6e53a
sub _encode_rdata {			## encode rdata as wire-format octet string
Packit Service f6e53a
	my $self = shift;
Packit Service f6e53a
Packit Service f6e53a
	return '' unless defined $self->{altitude};
Packit Service f6e53a
	join '', map $self->{$_}->encode, qw(latitude longitude altitude);
Packit Service f6e53a
}
Packit Service f6e53a
Packit Service f6e53a
Packit Service f6e53a
sub _format_rdata {			## format rdata portion of RR string.
Packit Service f6e53a
	my $self = shift;
Packit Service f6e53a
Packit Service f6e53a
	return '' unless defined $self->{altitude};
Packit Service f6e53a
	join ' ', map $self->{$_}->string, qw(latitude longitude altitude);
Packit Service f6e53a
}
Packit Service f6e53a
Packit Service f6e53a
Packit Service f6e53a
sub _parse_rdata {			## populate RR from rdata in argument list
Packit Service f6e53a
	my $self = shift;
Packit Service f6e53a
Packit Service f6e53a
	$self->latitude(shift);
Packit Service f6e53a
	$self->longitude(shift);
Packit Service f6e53a
	$self->altitude(shift);
Packit Service f6e53a
	die 'too many arguments for GPOS' if scalar @_;
Packit Service f6e53a
}
Packit Service f6e53a
Packit Service f6e53a
Packit Service f6e53a
sub _defaults {				## specify RR attribute default values
Packit Service f6e53a
	my $self = shift;
Packit Service f6e53a
Packit Service f6e53a
	$self->_parse_rdata(qw(0.0 0.0 0.0));
Packit Service f6e53a
}
Packit Service f6e53a
Packit Service f6e53a
Packit Service f6e53a
sub latitude {
Packit Service f6e53a
	my $self = shift;
Packit Service f6e53a
	$self->{latitude} = _fp2text(shift) if scalar @_;
Packit Service f6e53a
	_text2fp( $self->{latitude} ) if defined wantarray;
Packit Service f6e53a
}
Packit Service f6e53a
Packit Service f6e53a
Packit Service f6e53a
sub longitude {
Packit Service f6e53a
	my $self = shift;
Packit Service f6e53a
	$self->{longitude} = _fp2text(shift) if scalar @_;
Packit Service f6e53a
	_text2fp( $self->{longitude} ) if defined wantarray;
Packit Service f6e53a
}
Packit Service f6e53a
Packit Service f6e53a
Packit Service f6e53a
sub altitude {
Packit Service f6e53a
	my $self = shift;
Packit Service f6e53a
	$self->{altitude} = _fp2text(shift) if scalar @_;
Packit Service f6e53a
	_text2fp( $self->{altitude} ) if defined wantarray;
Packit Service f6e53a
}
Packit Service f6e53a
Packit Service f6e53a
Packit Service f6e53a
########################################
Packit Service f6e53a
Packit Service f6e53a
sub _fp2text {
Packit Service f6e53a
	return new Net::DNS::Text( sprintf( '%1.10g', shift ) );
Packit Service f6e53a
}
Packit Service f6e53a
Packit Service f6e53a
sub _text2fp {
Packit Service f6e53a
	no integer;
Packit Service f6e53a
	return 0.0 + shift->value;
Packit Service f6e53a
}
Packit Service f6e53a
Packit Service f6e53a
Packit Service f6e53a
1;
Packit Service f6e53a
__END__
Packit Service f6e53a
Packit Service f6e53a
Packit Service f6e53a
=head1 SYNOPSIS
Packit Service f6e53a
Packit Service f6e53a
    use Net::DNS;
Packit Service f6e53a
    $rr = new Net::DNS::RR('name GPOS latitude longitude altitude');
Packit Service f6e53a
Packit Service f6e53a
=head1 DESCRIPTION
Packit Service f6e53a
Packit Service f6e53a
Class for DNS Geographical Position (GPOS) resource records.
Packit Service f6e53a
Packit Service f6e53a
=head1 METHODS
Packit Service f6e53a
Packit Service f6e53a
The available methods are those inherited from the base class augmented
Packit Service f6e53a
by the type-specific methods defined in this package.
Packit Service f6e53a
Packit Service f6e53a
Use of undocumented package features or direct access to internal data
Packit Service f6e53a
structures is discouraged and could result in program termination or
Packit Service f6e53a
other unpredictable behaviour.
Packit Service f6e53a
Packit Service f6e53a
Packit Service f6e53a
=head2 latitude
Packit Service f6e53a
Packit Service f6e53a
    $latitude = $rr->latitude;
Packit Service f6e53a
    $rr->latitude( $latitude );
Packit Service f6e53a
Packit Service f6e53a
Floating-point representation of latitude, in degrees.
Packit Service f6e53a
Packit Service f6e53a
=head2 longitude
Packit Service f6e53a
Packit Service f6e53a
    $longitude = $rr->longitude;
Packit Service f6e53a
    $rr->longitude( $longitude );
Packit Service f6e53a
Packit Service f6e53a
Floating-point representation of longitude, in degrees.
Packit Service f6e53a
Packit Service f6e53a
=head2 altitude
Packit Service f6e53a
Packit Service f6e53a
    $altitude = $rr->altitude;
Packit Service f6e53a
    $rr->altitude( $altitude );
Packit Service f6e53a
Packit Service f6e53a
Floating-point representation of altitude, in metres.
Packit Service f6e53a
Packit Service f6e53a
Packit Service f6e53a
=head1 COPYRIGHT
Packit Service f6e53a
Packit Service f6e53a
Copyright (c)1997,1998 Michael Fuhr. 
Packit Service f6e53a
Packit Service f6e53a
All rights reserved.
Packit Service f6e53a
Packit Service f6e53a
Package template (c)2009,2012 O.M.Kolkman and R.W.Franks.
Packit Service f6e53a
Packit Service f6e53a
Packit Service f6e53a
=head1 LICENSE
Packit Service f6e53a
Packit Service f6e53a
Permission to use, copy, modify, and distribute this software and its
Packit Service f6e53a
documentation for any purpose and without fee is hereby granted, provided
Packit Service f6e53a
that the above copyright notice appear in all copies and that both that
Packit Service f6e53a
copyright notice and this permission notice appear in supporting
Packit Service f6e53a
documentation, and that the name of the author not be used in advertising
Packit Service f6e53a
or publicity pertaining to distribution of the software without specific
Packit Service f6e53a
prior written permission.
Packit Service f6e53a
Packit Service f6e53a
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
Packit Service f6e53a
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
Packit Service f6e53a
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
Packit Service f6e53a
THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
Packit Service f6e53a
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
Packit Service f6e53a
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
Packit Service f6e53a
DEALINGS IN THE SOFTWARE.
Packit Service f6e53a
Packit Service f6e53a
Packit Service f6e53a
=head1 SEE ALSO
Packit Service f6e53a
Packit Service f6e53a
L<perl>, L<Net::DNS>, L<Net::DNS::RR>, RFC1712
Packit Service f6e53a
Packit Service f6e53a
=cut