Number::Phone::Formatters - how to write custom formatters
How to write custom formatters for phone numbers.
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
The 'FishAndChips' formatter name is reserved because I needed something guaranteed to not exist so I could test that it failed correctly.
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 first argument, looking something like '+CC NNN NNN NNN', and a Number::Phone object as its second argument. The gory details of what E.123 looks like are at http://www.itu.int/rec/T-REC-E.123/en but in summary, you'll get a string consisting of:
You should return a string.
Copyright 2016 David Cantrell <firstname.lastname@example.org>
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/.