table of contents
Number::Phone::Formatters(3pm) | User Contributed Perl Documentation | Number::Phone::Formatters(3pm) |
NAME¶
Number::Phone::Formatters - how to write custom formattersDESCRIPTION¶
How to write custom formatters for phone numbers.NAMING¶
Formatters are modules that live in the "Number::Phone::Formatter::*" namespace. Users only need to type the last bit of the name, without the leading "Number::Phone::Formatter::", when calling the "format_using" method of Number::Phone.The 'E123' formatter name is reserved and implemented by Number::Phone subclasses in their "format()" methods.
The 'FishAndChips' formatter name is reserved because I needed something guaranteed to not exist so I could test that it failed correctly.
METHODS¶
There is one compulsory method, "format" that you must write. It will be called as a class method, with a number in E.123 international format as its only argument, looking something like '+CC NNN NNN NNN'. The gory details are at <http://www.itu.int/rec/T-REC-E.123/en> but in summary, you'll get:- a plus sign
- a 1, 2 or 3 digit country code
- whitespace
- a mixture of digits and whitespace
EXAMPLE¶
See Number::Phone::Formatter::Raw for an example.COPYRIGHT and LICENCE¶
Copyright 2016 David Cantrell <david@cantrell.org.uk>This documentation is free-as-in-speech software. It may be used, distributed, and modified under the terms of the Creative Commons Attribution-Share Alike 2.0 UK: England & Wales License, whose text you may read at <http://creativecommons.org/licenses/by-sa/2.0/uk/>.
2016-12-15 | perl v5.24.1 |