File Coverage

blib/lib/Number/Phone/NANP/US.pm

Criterion	Covered	Total	%
statement	7	7	100.0
branch			n/a
condition			n/a
subroutine	3	3	100.0
pod	1	1	100.0
total	11	11	100.0

package Number::Phone::NANP::US;

use strict;

use base 'Number::Phone::NANP';

our $VERSION = 1.1001;

my $cache = {};

# NB this module doesn't register itself, the NANP module should be
# used and will load this one as necessary

=head1 NAME

Number::Phone::NANP::US - US-specific methods for Number::Phone

=head1 DESCRIPTION

This class implements US-specific methods for Number::Phone.  It is
a subclass of Number::Phone::NANP, which is in turn a subclass of
Number::Phone.  Number::Phone::NANP sits in the middle because all
NANP countries can share some significant chunks of code.  You should
never need to C this module directly, as C
will load it automatically when needed.

=head1 SYNOPSIS

    use Number::Phone::NANP;

    my $phone_number = Number::Phone->new('[phone]');
    # returns a Number::Phone::NANP::US object

=head1 METHODS

The following methods from Number::Phone::NANP are overridden:

=over 4

=item data_source

Returns a string telling where and when the data for US operators was last updated, looking something like:

    "National Pooling Administrator at Wed Sep 30 10:37:39 2020 UTC"

The current value of this is also documented in L.

=item regulator

The national telecomms regulator

=cut

sub regulator { return 'FCC, http://www.fcc.gov/'; }

=back

=head1 BUGS/FEEDBACK

Please report bugs at L, including, if possible, a test case.

I welcome feedback from users.

=head1 LICENCE

You may use, modify and distribute this software under the same terms as
perl itself.

=head1 AUTHOR

David Cantrell [e-mail]

Copyright 2023

=cut

1;