Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
Number::Phone::JP(3)  User Contributed Perl Documentation Number::Phone::JP(3)

NAME
       Number::Phone::JP - Validate Japanese phone numbers

SYNOPSIS
	use Number::Phone::JP;

	my $tel	= Number::Phone::JP->new('012',	'34567890');
	print "This is valid!!\n" if $tel->is_valid_number;

	$tel->set_number('098 7654 3210');
	print "This is valid!!\n" if $tel->is_valid_number;

	$tel->import(qw(mobile PHS));
	$tel->set_number('090-0123-4567');
	print "This is valid!!\n" if $tel->is_valid_number;

DESCRIPTION
       Number::Phone::JP is a simple module to validate	Japanese phone number
       formats.	The Japanese phone numbers are regulated by Ministry of
       Internal	Afairs and Communications of Japan.  You can validate what a
       target number is	valid from this	regulation point of view.

       There are many categories for type of telephones	in Japan. This module
       is able to be used narrowed down	to the type of phones.

       This module only	validates what a phone number agrees on	the
       regulation. Therefore, it does NOT validate what	a phone	number
       actually	exists.

       This validation needs only an area (or category)	prefix and behind it.
       The separator of	number behind the prefix is ignored.

METHODS
   new
       This method constructs the Number::Phone::JP instance. you can put some
       argument	of a phone number to it.  It needs a two stuff for validation,
       area prefix (or carrier's prefix) and following (means local-area
       prefix, subscriber's number, and	something).

       If you put only one argument, this module will separate it by the first
       non-number character. And it will be ignored any	non-number characters.

   import
       It exists to select what	categories is used for validation. You should
       pass some specified categories to this method.

       Categories list is as follows:

	Class1	 ... Class1 undertaking	associations
	Class2	 ... Class2 undertaking	associations
	Freedial ... Freedials
	Home	 ... Household phones
	IPPhone	 ... IP	phones
	Mobile	 ... Mobile phones
	Pager	 ... Pager (called "pocketbell")
	PHS	 ... Personal Handy-phone Systems
	Q2	 ... Dial Q2 services
	United	 ... United phone number
	FMC	 ... Fixed Mobile Convergence
		     (was started in 2007 in Japan)
	UPT	 ... Universal Personal	Telecommunication
		     (was merged to FMC	category in 2007 in Japan.
		      this class works same as FMC.
		      it's left	for backward compatibility.)

       The category's names are	ignored	case. Actually,	the import method
       calls others "Number::Phone::JP::Table::"Category module	and import
       this. The default importing table, "Number::Phone::JP::Table" module is
       including all the categories table.

       For importing, you can import by	calling	this method, and you can
       import by calling this module with some arguments.

	Example:
	 # by calling import method
	 use Number::Phone::JP;	# import all the categories (default)
	 my $tel = Number::Phone::JP->new->import(qw(mobile PHS));

	 # by calling this module
	 use Number::Phone::JP qw(Mobile Phs);
	 my $tel = Number::Phone::JP->new; # same as above

   set_number
       Set/change the target phone number. The syntax of arguments for this
       method is same as "new()" method	(see above).

   is_valid_number
       This method validates what the already set number is valid on your
       specified categories. It	returns	true if	the number is valid, and
       returns false if	the number is invalid.

Number::Phone COMPATIBLE METHODS
   is_valid
       Simply you can call "is_valid()"	method instead of "is_valid_number".

   is_mobile
       It checks that is the prefix of the number which	you set	is used	for
       mobile numbers. It just checks only prefix.

   is_pager
       It checks that is the prefix of the number which	you set	is used	for
       pager (a.k.a pocketbell)	numbers. It just checks	only prefix.

   is_ipphone
       It checks that is the prefix of the number which	you set	is used	for IP
       phone numbers. It just checks only prefix.

   is_tollfree
       It checks that is the prefix of the number which	you set	is used	for IP
       tollfree	(a.k.a.	freedial) numbers. It just checks only prefix.

   is_specialrate
       It checks that is the prefix of the number which	you set	is used	for
       specialrate (a.k.a. dial	Q2) numbers. It	just checks only prefix.

   country_code
       The numeric code	for Japan. Just	returns	81. Note that there is *no* +
       sign.

   format
       Return a	sanely formatted version of the	number,	complete with IDD
       code, eg	for the	Japanese number	090-0123-4567 it would return +81 90
       01234567.

UNIMPLEMENTED METHODS
       Following methods are not implemented on	this module. It	just returns
       undef.

   is_allocated
   is_in_use
   is_geographic
   is_fixed_line
   is_isdn
   is_adult
   is_personal
   is_corporate
   is_government
   is_international
   is_network_service
   regulator
   areacode
   areaname
   location
   subscriber
   operator
   type
   country
   translates_to
EXAMPLE
	use Number::Phone::JP qw(mobile	phs);

	my $tel	= Number::Phone::JP->new;
	open FH, 'customer.list' or die	"$!";
	while (<FH>) {
	    chomp;
	    unless ($tel->set_number($_)->is_valid_number) {
		print "$_ is invalid number\n"
	    }
	}
	close FH;

AUTHOR
       Koichi Taniguchi	(a.k.a.	nipotan) <taniguchi@cpan.org>

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

SEE ALSO
       Number::Phone::JP::Table

perl v5.24.1			  2017-06-01		  Number::Phone::JP(3)

NAME | SYNOPSIS | DESCRIPTION | METHODS | Number::Phone COMPATIBLE METHODS | UNIMPLEMENTED METHODS | EXAMPLE | AUTHOR | LICENSE | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=Number::Phone::JP&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help