Punic APIs
  • Namespace
  • Class
  • Tree
  • Todo

Namespaces

  • Punic
    • Exception

Classes

  • Punic\Calendar
  • Punic\Comparer
  • Punic\Currency
  • Punic\Data
  • Punic\Language
  • Punic\Misc
  • Punic\Number
  • Punic\Phone
  • Punic\Plural
  • Punic\Territory
  • Punic\Unit

Exceptions

  • Punic\Exception
  • Punic\Exception\BadArgumentType
  • Punic\Exception\BadDataFileContents
  • Punic\Exception\DataFileNotFound
  • Punic\Exception\DataFileNotReadable
  • Punic\Exception\DataFolderNotFound
  • Punic\Exception\InvalidDataFile
  • Punic\Exception\InvalidLocale
  • Punic\Exception\NotImplemented
  • Punic\Exception\ValueNotInList
 1  2  3  4  5  6  7  8  9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 
<?php

namespace Punic;

/**
 * Numbers helpers.
 */
class Phone
{
    /**
     * Retrieve the list of the country calling codes for a specific country.
     *
     * @param string $territoryCode The country identifier ('001' for global systems, for instance satellite communications like Iridium)
     *
     * @return array Returns the list of country calling codes found for the specified country (eg: for 'US' you'll get array('1'))
     */
    public static function getPrefixesForTerritory($territoryCode)
    {
        $result = array();
        if (is_string($territoryCode) && preg_match('/^([a-z]{2}|[0-9]{3})$/i', $territoryCode)) {
            $territoryCode = strtoupper($territoryCode);
            $data = Data::getGeneric('telephoneCodeData');
            if (isset($data[$territoryCode])) {
                $result = $data[$territoryCode];
            }
        }

        return $result;
    }

    /**
     * Retrieve the list of territory codes for a specific prefix.
     *
     * @param string $prefix The country calling code (for instance: '1')
     *
     * @return array Returns the list of territories for which the specified prefix is applicable (eg: for '1' you'll get array('US', 'AG', 'AI', 'CA', ...))
     */
    public static function getTerritoriesForPrefix($prefix)
    {
        $result = array();
        if (is_string($prefix) && preg_match('/^[0-9]+$/', $prefix)) {
            $data = Data::getGeneric('telephoneCodeData');
            foreach ($data as $territoryCode => $prefixes) {
                if (in_array($prefix, $prefixes)) {
                    $result[] = $territoryCode;
                }
            }
        }

        return $result;
    }

    /**
     * Retrieve the max length of the country calling codes.
     *
     * @return int
     */
    public static function getMaxPrefixLength()
    {
        static $result;
        if (!isset($result)) {
            $maxLen = 0;
            $data = Data::getGeneric('telephoneCodeData');
            foreach ($data as $territoryCode => $prefixes) {
                foreach ($prefixes as $prefix) {
                    $len = strlen($prefix);
                    if ($maxLen < $len) {
                        $maxLen = $len;
                    }
                }
            }
            $result = $maxLen;
        }

        return $result;
    }
}
Punic APIs API documentation generated by ApiGen