Number::Phone::Lib - Instantiate Number::Phone::* objects from libphonenumber

       •   David Cantrell <david@cantrell.org.uk>

       •   David E. Wheeler <david@justatheory.com>

       Copyright 2025

perl v5.40.1                                       2025-03-29                            Number::Phone::Lib(3pm)

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

       There is one method, a constructor:

   new
       Call this in exactly the same way as you would call "Number::Phone-"new()>. The only difference  is  that
       you will get stubs back instead of "full-fat" objects, even if full-fat classes are available.

       Number::Phone::Lib - Instantiate Number::Phone::* objects from libphonenumber

           use Number::Phone::Lib;

           $daves_phone = Number::Phone::Lib->new('+442087712924');
           $daves_other_phone = Number::Phone::Lib->new('+44 7979 866 975');
           # alternatively      Number::Phone::Lib->new('+44', '7979 866 975');
           # or                 Number::Phone::Lib->new('UK', '07979 866 975');

           if ( $daves_phone->is_mobile() ) {
               send_rude_SMS();
           }

       This subclass of Number::Phone is used in exactly the same way as the normal Number::Phone, but it
       exclusively uses classes generated from Google's libphonenumber project
       <https://code.google.com/p/libphonenumber/>.  libphonenumber doesn't have enough data to support all the
       features of Number::Phone, but you might want to use its data and no other for a few reasons:

       •   Compatibility with libphonenumber's Java, C++, and JavaScript implementations.

       •   Performance.  UK Number parsing and validation by Number::Phone::UK, in particular, has a substantial
           overhead thanks to its embedded database. If all you need is simple validation and/or formatting, all
           that overhead is unnecessary.

       That said, the core Number::Phone UK module is far more comprehensive.