If the number is not considered possible for the numbering plan of the default region
initially, but starts with the country calling code of this region, validation will be
reattempted after stripping this country calling code. If this number is considered a
possible number, then the first digits will be considered the country calling code and
removed as such.
It will throw a NumberParseException if the number starts with a '+' but the country calling
code supplied after this does not match that of any known region.
|
public maybeExtractCountryCode ( string $number, |
||
| $number | string | non-normalized telephone number that we wish to extract a country calling code from - may begin with '+' |
| $defaultRegionMetadata | metadata about the region this number may be from | |
| $nationalNumber | string | a string buffer to store the national significant number in, in the case that a country calling code was extracted. The number is appended to any existing contents. If no country calling code was extracted, this will be left unchanged. |
| $keepRawInput | boolean | true if the country_code_source and preferred_carrier_code fields of phoneNumber should be populated. |
| $phoneNumber | the PhoneNumber object where the country_code and country_code_source need to be populated. Note the country_code is always populated, whereas country_code_source is only populated when keepCountryCodeSource is true. | |
| Результат | integer | the country calling code extracted or 0 if none could be extracted |
public function testMaybeExtractCountryCode()
{
$number = new PhoneNumber();
$metadata = $this->phoneUtil->getMetadataForRegion(RegionCode::US);
// Note that for the US, the IDD is 011.
try {
$phoneNumber = "011112-3456789";
$strippedNumber = "123456789";
$countryCallingCode = 1;
$numberToFill = "";
$this->assertEquals($countryCallingCode, $this->phoneUtil->maybeExtractCountryCode($phoneNumber, $metadata, $numberToFill, true, $number), "Did not extract country calling code " . $countryCallingCode . " correctly.");
$this->assertEquals(CountryCodeSource::FROM_NUMBER_WITH_IDD, $number->getCountryCodeSource(), "Did not figure out CountryCodeSource correctly");
// Should strip and normalize national significant number.
$this->assertEquals($strippedNumber, $numberToFill, "Did not strip off the country calling code correctly.");
} catch (NumberParseException $e) {
$this->fail("Should not have thrown an exception: " . $e->getMessage());
}
$number->clear();
try {
$phoneNumber = "+6423456789";
$countryCallingCode = 64;
$numberToFill = "";
$this->assertEquals($countryCallingCode, $this->phoneUtil->maybeExtractCountryCode($phoneNumber, $metadata, $numberToFill, true, $number), "Did not extract country calling code " . $countryCallingCode . " correctly.");
$this->assertEquals(CountryCodeSource::FROM_NUMBER_WITH_PLUS_SIGN, $number->getCountryCodeSource(), "Did not figure out CountryCodeSource correctly");
} catch (NumberParseException $e) {
$this->fail("Should not have thrown an exception: " . $e->getMessage());
}
$number->clear();
try {
$phoneNumber = "+80012345678";
$countryCallingCode = 800;
$numberToFill = "";
$this->assertEquals($countryCallingCode, $this->phoneUtil->maybeExtractCountryCode($phoneNumber, $metadata, $numberToFill, true, $number), "Did not extract country calling code " . $countryCallingCode . " correctly.");
$this->assertEquals(CountryCodeSource::FROM_NUMBER_WITH_PLUS_SIGN, $number->getCountryCodeSource(), "Did not figure out CountryCodeSource correctly");
} catch (NumberParseException $e) {
$this->fail("Should not have thrown an exception: " . $e->getMessage());
}
$number->clear();
try {
$phoneNumber = "2345-6789";
$numberToFill = "";
$this->assertEquals(0, $this->phoneUtil->maybeExtractCountryCode($phoneNumber, $metadata, $numberToFill, true, $number), "Should not have extracted a country calling code - no international prefix present.");
$this->assertEquals(CountryCodeSource::FROM_DEFAULT_COUNTRY, $number->getCountryCodeSource(), "Did not figure out CountryCodeSource correctly");
} catch (NumberParseException $e) {
$this->fail("Should not have thrown an exception: " . $e->getMessage());
}
$number->clear();
try {
$phoneNumber = "0119991123456789";
$numberToFill = "";
$this->phoneUtil->maybeExtractCountryCode($phoneNumber, $metadata, $numberToFill, true, $number);
$this->fail("Should have thrown an exception, no valid country calling code present.");
} catch (NumberParseException $e) {
// Expected.
$this->assertEquals(NumberParseException::INVALID_COUNTRY_CODE, $e->getErrorType(), "Wrong error type stored in exception.");
}
$number->clear();
try {
$phoneNumber = "(1 610) 619 4466";
$countryCallingCode = 1;
$numberToFill = "";
$this->assertEquals($countryCallingCode, $this->phoneUtil->maybeExtractCountryCode($phoneNumber, $metadata, $numberToFill, true, $number), "Should have extracted the country calling code of the region passed in");
$this->assertEquals(CountryCodeSource::FROM_NUMBER_WITHOUT_PLUS_SIGN, $number->getCountryCodeSource(), "Did not figure out CountryCodeSource correctly");
} catch (NumberParseException $e) {
$this->fail("Should not have thrown an exception: " . $e->getMessage());
}
$number->clear();
try {
$phoneNumber = "(1 610) 619 4466";
$countryCallingCode = 1;
$numberToFill = "";
$this->assertEquals($countryCallingCode, $this->phoneUtil->maybeExtractCountryCode($phoneNumber, $metadata, $numberToFill, false, $number), "Should have extracted the country calling code of the region passed in");
$this->assertFalse($number->hasCountryCodeSource(), "Should not contain CountryCodeSource");
} catch (NumberParseException $e) {
$this->fail("Should not have thrown an exception: " . $e->getMessage());
}
$number->clear();
try {
$phoneNumber = "(1 610) 619 446";
$numberToFill = "";
$this->assertEquals(0, $this->phoneUtil->maybeExtractCountryCode($phoneNumber, $metadata, $numberToFill, false, $number), "Should not have extracted a country calling code - invalid number after extraction of uncertain country calling code.");
$this->assertFalse($number->hasCountryCodeSource(), "Should not contain CountryCodeSource");
} catch (NumberParseException $e) {
$this->fail("Should not have thrown an exception: " . $e->getMessage());
}
$number->clear();
try {
$phoneNumber = "(1 610) 619";
$numberToFill = "";
$this->assertEquals(0, $this->phoneUtil->maybeExtractCountryCode($phoneNumber, $metadata, $numberToFill, true, $number), "Should not have extracted a country calling code - too short number both before and after extraction of uncertain country calling code.");
$this->assertEquals(CountryCodeSource::FROM_DEFAULT_COUNTRY, $number->getCountryCodeSource(), "Did not figure out CountryCodeSource correctly");
} catch (NumberParseException $e) {
$this->fail("Should not have thrown an exception: " . $e->getMessage());
}
}
