View on
MetaCPAN
search.cpan.org is shutting down
For details read Perl NOC. After June 25th this page will redirect to MetaCPAN.org
John Karr > String-Validator-Phone-NANP > String::Validator::Phone::NANP

Download:
String-Validator-Phone-NANP-2.00.tar.gz

Dependencies

Annotate this POD

Website

View/Report Bugs
Module Version: 2.00   Source  

NAME ^

String::Validator::Phone::NANP - Validate North American Phone Numbers

VERSION ^

version 2.00

SYNOPSIS ^

String::Validator::Phone::NANP is part of the String Validator Collection. It checks a string against validation rules for phone numbers from countries participating in the North American Numbering Plan, which includes the United States and Canada.

NAME ^

String::Validator::Phone::NANP - Check a Phone Number (North American Numbering Plan)!

String::Validator Methods and Usage ^

Provides and conforms to the standard String::Validator methods, please see String::Validator for general documentation, and String::Validator::Common for information on the base String::Validator Class.

Methods Specific to String::Validator::Phone::NANP ^

Parameters to New with (default) behaviour.

 alphanum    (OFF) : Allow Alphanumeric formats.

Original, String, International, Areacode, Parens, Exchange, Local

Returns:

Original: the Orignial string provided,

String: the internal representations of the phone number, which is in the format of AREA-EXCHANGE-NUMBER, (the most commonly used representation in the United States).

International: Prepends 1- in front of the string.

Areacode, Exchange, Local: Returns each of the 3 components of a number

Parens: Formats the number (AREA) EXCHANGE-LOCAL.

Number_Phone

Returns a Number::Phone::NANP object based on the current phone number, if the last number evaluated was not valid it returns 0.

Example ^

 use String::Validator::Phone::NANP ;
 my $Validator = String::Validator::Phone::NANP->new( alphanum => 1 ) ;

 if ( $Validator->IsNot_Valid( '6464') { say $Validator->Errstr() }
 # IsNot_Valid returns Errstr on failure.
 # So the preceding and following are the same.
 my $badone = $Validator->IsNot_Valid( '999') ;
 if ( $badone ) { say "$badone' } ;

 if ( $Validator->Is_Valid( '646-SG7-6464' ) { say "good" }
 say $Validator->Areacode ; # print the Areacode.
 my $PhoneNum = $Validator->Number_Phone ; # Get a Number Phone object.
 say $PhoneNum->country; # Prints the two letter country code of the number.

ToDo ^

The major TO DO items are to provide String::Validator::Phone modules for other numbering schemes and to fully encapsulate Number::Phone.

AUTHOR ^

John Karr, <brainbuz at brainbuz.org>

SUPPORT ^

You can find documentation for this module with the perldoc command.

    perldoc String::Validator::Phone

Bug Reports and Patches ^

Please submit Bug Reports and Patches via https://github.com/brainbuz/String-Validator.

ACKNOWLEDGEMENTS ^

LICENSE AND COPYRIGHT ^

Copyright 2012, 2018 John Karr.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, version 3 or at your option any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

A copy of the GNU General Public License is available in the source tree; if not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.

AUTHOR ^

John Karr <brainbuz@brainbuz.org>

COPYRIGHT AND LICENSE ^

This software is Copyright (c) 2014,2018 by John Karr.

This is free software, licensed under:

  The GNU General Public License, Version 3, June 2007
syntax highlighting: