Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
- API
  
  Reference documentation for the pkg.go.dev API
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

phone

package module

Go to main page

Versions in this module

v0

v0.0.7

Jun 29, 2026

Changes in this version

+ const DIGITS

+ const DIGIT_PLACEHOLDER

+ const Default_NumberFormat_NationalPrefixOptionalWhenFormatting

+ const Default_PhoneMetadata_LeadingZeroPossible

+ const Default_PhoneMetadata_MainCountryForCode

+ const Default_PhoneMetadata_MobileNumberPortableRegion

+ const Default_PhoneMetadata_SameMobileAndFixedLinePattern

+ const Default_PhoneNumber_NumberOfLeadingZeros

+ const MAX_INPUT_STRING_LENGTH

+ const MAX_LENGTH_COUNTRY_CODE

+ const MAX_LENGTH_FOR_NSN

+ const MIN_LEADING_DIGITS_LENGTH

+ const MIN_LENGTH_FOR_NSN

+ const MetadataVersion

+ const NANPA_COUNTRY_CODE

+ const PLUS_CHARS

+ const PLUS_SIGN

+ const RFC3966_EXTN_PREFIX

+ const RFC3966_ISDN_SUBADDRESS

+ const RFC3966_PHONE_CONTEXT

+ const RFC3966_PREFIX

+ const SEPARATOR_BEFORE_NATIONAL_NUMBER

+ const STAR_SIGN

+ const UNKNOWN_REGION

+ const UNKNOWN_TIMEZONE

+ const VALID_ALPHA

+ const VALID_PUNCTUATION

+ var ALL_PLUS_NUMBER_GROUPING_SYMBOLS = map[rune]rune

+ var ALPHANUM = VALID_ALPHA + DIGITS

+ var ALPHA_MAPPINGS = map[rune]rune

+ var ALPHA_PHONE_MAPPINGS = map[rune]rune

+ var CAPTURING_DIGIT_PATTERN = regexp.MustCompile("(" + DIGITS + ")")

+ var CC_PATTERN = regexp.MustCompile(`\$CC`)

+ var COUNTRIES_WITHOUT_NATIONAL_PREFIX_WITH_AREA_CODES = map[int32]bool

+ var Countries = map[string]Country

+ var CountryNetwork = map[string][]Network

+ var DEFAULT_EXTN_PREFIX = " ext. "

+ var DIALLABLE_CHAR_MAPPINGS = map[rune]rune

+ var DIGITS_PATTERN = regexp.MustCompile(`(\d+)`)

+ var ELIGIBLE_FORMAT_PATTERN = regexp.MustCompile(...)

+ var EMPTY_METADATA = &PhoneMetadata

+ var EXTN_PATTERN = regexp.MustCompile("(?i)(?:" + EXTN_PATTERNS_FOR_PARSING + ")$")

+ var EXTN_PATTERNS_FOR_MATCHING = ...

+ var EXTN_PATTERNS_FOR_PARSING = ...

+ var ErrEmptyMetadata = errors.New("empty metadata")

+ var ErrInvalidCountryCode = errors.New("invalid country code")

+ var ErrInvalidIndex = errors.New("phonenumbers.StringBuilder: invalid index")

+ var ErrNotANumber = errors.New("the phone number supplied is not a number")

+ var ErrNumTooLong = errors.New("the string supplied is too long to be a phone number")

+ var ErrTooShortAfterIDD = errors.New(...)

+ var ErrTooShortNSN = errors.New("the string supplied is too short to be a phone number")

+ var FG_PATTERN = regexp.MustCompile(`\$FG`)

+ var FIRST_GROUP_ONLY_PREFIX_PATTERN = regexp.MustCompile(`^\(?\$1\)?$`)

+ var FIRST_GROUP_PATTERN = regexp.MustCompile(`(\$\d)`)

+ var File_phonemetadata_proto protoreflect.FileDescriptor

+ var File_phonenumber_proto protoreflect.FileDescriptor

+ var GEO_MOBILE_COUNTRIES = map[int32]bool

+ var GEO_MOBILE_COUNTRIES_WITHOUT_MOBILE_AREA_CODES = map[int32]bool

+ var MOBILE_TOKEN_MAPPINGS = map[int]string

+ var NATIONAL_PREFIX_SEPARATORS_PATTERN = regexp.MustCompile("[- ]")

+ var NON_DIGITS_PATTERN = regexp.MustCompile(`(\D+)`)

+ var NOT_SEPARATOR_PATTERN = regexp.MustCompile("[^" + VALID_PUNCTUATION + "]+")

+ var NP_PATTERN = regexp.MustCompile(`\$NP`)

+ var PLUS_CHARS_PATTERN = regexp.MustCompile("[" + PLUS_CHARS + "]+")

+ var PhoneNumber_CountryCodeSource_name = map[int32]string

+ var PhoneNumber_CountryCodeSource_value = map[string]int32

+ var REGIONS_WHERE_EMERGENCY_NUMBERS_MUST_BE_EXACT = []string

+ var REGION_CODE_FOR_NON_GEO_ENTITY = "001"

+ var RFC3966_DOMAINLABEL = "[" + ALPHANUM + "]+((\\-)*[" + ALPHANUM + "])*"

+ var RFC3966_DOMAINNAME = "^(" + RFC3966_DOMAINLABEL + "\\.)*" + RFC3966_TOPLABEL + "\\.?$"

+ var RFC3966_DOMAINNAME_PATTERN = regexp.MustCompile(RFC3966_DOMAINNAME)

+ var RFC3966_GLOBAL_NUMBER_DIGITS = "^\\" + string(PLUS_SIGN) + RFC3966_PHONE_DIGIT + "*" + DIGITS + RFC3966_PHONE_DIGIT + "*$"

+ var RFC3966_GLOBAL_NUMBER_DIGITS_PATTERN = regexp.MustCompile(RFC3966_GLOBAL_NUMBER_DIGITS)

+ var RFC3966_PHONE_DIGIT = "(" + DIGITS + "|" + RFC3966_VISUAL_SEPARATOR + ")"

+ var RFC3966_TOPLABEL = "[" + VALID_ALPHA + "]+((\\-)*[" + ALPHANUM + "])*"

+ var RFC3966_VISUAL_SEPARATOR = "[\\-\\.\\(\\)]?"

+ var SECOND_NUMBER_START = "[\\\\/] *x"

+ var SECOND_NUMBER_START_PATTERN = regexp.MustCompile(SECOND_NUMBER_START)

+ var SEPARATOR_PATTERN = regexp.MustCompile("[" + VALID_PUNCTUATION + "]+")

+ var Type = map[int]string

+ var UNIQUE_INTERNATIONAL_PREFIX = regexp.MustCompile("^(?:[\\d]+(?:[~\u2053\u223C\uFF5E][\\d]+)?)$")

+ var UNWANTED_END_CHARS = "[^\\p{N}\\p{L}#]+$"

+ var UNWANTED_END_CHAR_PATTERN = regexp.MustCompile(UNWANTED_END_CHARS)

+ var VALID_ALPHA_PHONE_PATTERN = regexp.MustCompile("^(?:.*?[A-Za-z]){3}.*$")

+ var VALID_PHONE_NUMBER = ...

+ var VALID_PHONE_NUMBER_PATTERN = regexp.MustCompile("(?i)^(" + VALID_PHONE_NUMBER + "(?:" + EXTN_PATTERNS_FOR_PARSING + ")?)$")

+ var VALID_START_CHAR = "[" + PLUS_CHARS + DIGITS + "]"

+ var VALID_START_CHAR_PATTERN = regexp.MustCompile(VALID_START_CHAR)

+ func AllNumberGroupsAreExactlyPresent(number *PhoneNumber, normalizedCandidate string, ...) bool

+ func AllNumberGroupsRemainGrouped(number *PhoneNumber, normalizedCandidate string, ...) bool

+ func BuildCountryCodeToRegionMap(metadataCollection *PhoneMetadataCollection) map[int][]string

+ func CanBeInternationallyDialled(number *PhoneNumber) bool

+ func CheckNumberGroupingIsValid(number *PhoneNumber, candidate string, ...) bool

+ func Clean(phone []string, defaultRegion ...string) (VerifiedNumbers, UnverifiedNumbers)

+ func ConnectsToEmergencyNumber(number string, regionCode string) bool

+ func ContainsMoreThanOneSlashInNationalNumber(number *PhoneNumber, candidate string) bool

+ func ContainsOnlyValidXChars(number *PhoneNumber, candidate string) bool

+ func ConvertAlphaCharactersInNumber(number string) string

+ func CountryCodes() []string

+ func CountryNames() []string

+ func Currency(code string) string

+ func CurrencySymbol(code string) string

+ func FindNumbers(text, defaultRegion string) iter.Seq[*PhoneNumberMatch]

+ func FindNumbersWithLeniency(text, defaultRegion string, leniency Leniency, maxTries int) iter.Seq[*PhoneNumberMatch]

+ func Format(number *PhoneNumber, numberFormat PhoneNumberFormat) string

+ func FormatByPattern(number *PhoneNumber, numberFormat PhoneNumberFormat, ...) string

+ func FormatInOriginalFormat(number *PhoneNumber, regionCallingFrom string) string

+ func FormatNationalNumberWithCarrierCode(number *PhoneNumber, carrierCode string) string

+ func FormatNationalNumberWithPreferredCarrierCode(number *PhoneNumber, fallbackCarrierCode string) string

+ func FormatNumberForMobileDialing(number *PhoneNumber, regionCallingFrom string, withFormatting bool) string

+ func FormatOutOfCountryCallingNumber(number *PhoneNumber, regionCallingFrom string) string

+ func FormatOutOfCountryKeepingAlphaChars(number *PhoneNumber, regionCallingFrom string) string

+ func FormatWithBuf(number *PhoneNumber, numberFormat PhoneNumberFormat, ...)

+ func GetCarrierForNumber(number *PhoneNumber, lang string) (string, error)

+ func GetCarrierForValidNumber(number *PhoneNumber, lang string) (string, error)

+ func GetCarrierWithPrefixForNumber(number *PhoneNumber, lang string) (string, int, error)

+ func GetCountryCodeForRegion(regionCode string) int

+ func GetCountryMobileToken(countryCallingCode int) string

+ func GetGeocodingForNumber(number *PhoneNumber, lang string) (string, error)

+ func GetLengthOfGeographicalAreaCode(number *PhoneNumber) int

+ func GetLengthOfNationalDestinationCode(number *PhoneNumber) int

+ func GetNationalSignificantNumber(number *PhoneNumber) string

+ func GetNddPrefixForRegion(regionCode string, stripNonDigits bool) string

+ func GetRegionCodeForCountryCode(countryCallingCode int) string

+ func GetRegionCodeForNumber(number *PhoneNumber) string

+ func GetRegionCodesForCountryCode(countryCallingCode int) []string

+ func GetSafeCarrierDisplayNameForNumber(phoneNumber *PhoneNumber, lang string) (string, error)

+ func GetSupportedCallingCodes() map[int]bool

+ func GetSupportedGlobalNetworkCallingCodes() map[int]bool

+ func GetSupportedRegions() map[string]bool

+ func GetSupportedTypesForNonGeoEntity(countryCallingCode int) map[PhoneNumberType]bool

+ func GetSupportedTypesForRegion(regionCode string) map[PhoneNumberType]bool

+ func GetTimeZonesForGeographicalNumber(number *PhoneNumber) ([]string, error)

+ func GetTimeZonesForNumber(number *PhoneNumber) ([]string, error)

+ func GetTimezonesForNumber(number *PhoneNumber) ([]string, error)

+ func GetTimezonesForPrefix(number string) ([]string, error)

+ func IsAlphaNumber(number string) bool

+ func IsCarrierSpecific(number *PhoneNumber) bool

+ func IsCarrierSpecificForRegion(number *PhoneNumber, regionDialingFrom string) bool

+ func IsEmergencyNumber(number string, regionCode string) bool

+ func IsMobileNumberPortableRegion(regionCode string) bool

+ func IsNANPACountry(regionCode string) bool

+ func IsNationalPrefixPresentIfRequired(number *PhoneNumber) bool

+ func IsNumberGeographical(number *PhoneNumber) bool

+ func IsNumberGeographicalForType(numberType PhoneNumberType, countryCallingCode int) bool

+ func IsPossibleNumber(number *PhoneNumber) bool

+ func IsPossibleNumberForType(number *PhoneNumber, numberType PhoneNumberType) bool

+ func IsPossibleNumberFromRegion(number, regionDialingFrom string) bool

+ func IsPossibleShortNumber(number *PhoneNumber) bool

+ func IsPossibleShortNumberForRegion(number *PhoneNumber, regionDialingFrom string) bool

+ func IsSmsServiceForRegion(number *PhoneNumber, regionDialingFrom string) bool

+ func IsValidNumber(number *PhoneNumber) bool

+ func IsValidNumberForRegion(number *PhoneNumber, regionCode string) bool

+ func IsValidShortNumber(number *PhoneNumber) bool

+ func IsValidShortNumberForRegion(number *PhoneNumber, regionDialingFrom string) bool

+ func LoadNetworks() error

+ func MatchNationalNumber(number string, numberDesc *PhoneNumberDesc, allowPrefixMatch bool) bool

+ func MaybeSeparateExtensionFromPhone(rawPhone string) (phoneNumber string, extension string)

+ func Name(code string) string

+ func NormalizeDiallableCharsOnly(number string) string

+ func NormalizeDigitsOnly(number string) string

+ func ParseAndKeepRawInputToNumber(numberToParse, defaultRegion string, phoneNumber *PhoneNumber) error

+ func ParseToNumber(numberToParse, defaultRegion string, phoneNumber *PhoneNumber) error

+ func Phone(code string) string

+ func TruncateTooLongNumber(number *PhoneNumber) bool

+ func Worker(data map[string]string) bool

+ type AnalyzeCarrierResult struct

+ CarrierCode string

+ CarrierName string

+ CountryCode string

+ PhoneCount int

+ PhoneType string

+ type AnalyzeCountryResult struct

+ CountryCode string

+ PhoneCount int

+ PhoneType string

+ type AsYouTypeFormatter struct

+ func GetAsYouTypeFormatter(regionCode string) *AsYouTypeFormatter

+ func (aytf *AsYouTypeFormatter) Clear()

+ func (aytf *AsYouTypeFormatter) GetRememberedPosition() int

+ func (aytf *AsYouTypeFormatter) InputDigit(nextChar rune) string

+ func (aytf *AsYouTypeFormatter) InputDigitAndRememberPosition(nextChar rune) string

+ type CarrierStats struct

+ InvalidCount int

+ RS []*AnalyzeCarrierResult

+ Result map[string]*AnalyzeCarrierResult

+ TotalCount int

+ func StatsByCarrier(phone []string, defaultRegion ...string) CarrierStats

+ type Country struct

+ Code string

+ Currency string

+ CurrencySymbol string

+ Name string

+ Phone string

+ func GetCountry(code string) (Country, error)

+ type CountryStats struct

+ InvalidCount int

+ RS []*AnalyzeCountryResult

+ Result map[string]*AnalyzeCountryResult

+ TotalCount int

+ func StatsByCountry(phone []string, defaultRegion ...string) CountryStats

+ type Leniency int

+ const EXACT_GROUPING

+ const POSSIBLE

+ const STRICT_GROUPING

+ const VALID

+ func (l Leniency) Verify(number *PhoneNumber, candidate string) bool

+ type MatchType int

+ const EXACT_MATCH

+ const NOT_A_NUMBER

+ const NO_MATCH

+ const NSN_MATCH

+ const SHORT_NSN_MATCH

+ func IsNumberMatch(firstNumber, secondNumber string) MatchType

+ func IsNumberMatchWithNumbers(firstNumberIn, secondNumberIn *PhoneNumber) MatchType

+ func IsNumberMatchWithOneNumber(firstNumber *PhoneNumber, secondNumber string) MatchType

+ type Network struct

+ Bands string

+ Brand string

+ CountryCode string

+ CountryName string

+ Lat string

+ Long string

+ Mcc string

+ Mnc string

+ NibbledPlmn string

+ Notes interface{}

+ Operator string

+ Plmn string

+ Region string

+ Status string

+ Type string

+ type Number struct

+ CarrierMcc string

+ CarrierMnc string

+ CarrierName string

+ CarrierNnc string

+ CountryCode string

+ CountryName string

+ Currency string

+ CurrencySymbol string

+ DefaultPrefix string

+ DialCode int32

+ Invalid bool

+ Phone string

+ PhoneType int

+ PhoneTypeHuman string

+ Timezone string

+ func Verify(phone string, defaultRegion ...string) Number

+ func (p *Number) Verify(getCarrierInfo ...bool)

+ type NumberFormat struct

+ DomesticCarrierCodeFormattingRule *string

+ Format *string

+ LeadingDigitsPattern []string

+ NationalPrefixFormattingRule *string

+ NationalPrefixOptionalWhenFormatting *bool

+ Pattern *string

+ func (*NumberFormat) Descriptor() ([]byte, []int)

+ func (*NumberFormat) ProtoMessage()

+ func (x *NumberFormat) GetDomesticCarrierCodeFormattingRule() string

+ func (x *NumberFormat) GetFormat() string

+ func (x *NumberFormat) GetLeadingDigitsPattern() []string

+ func (x *NumberFormat) GetNationalPrefixFormattingRule() string

+ func (x *NumberFormat) GetNationalPrefixOptionalWhenFormatting() bool

+ func (x *NumberFormat) GetPattern() string

+ func (x *NumberFormat) ProtoReflect() protoreflect.Message

+ func (x *NumberFormat) Reset()

+ func (x *NumberFormat) String() string

+ type NumberFormatE struct

+ CarrierCodeFormattingRule string

+ Format string

+ InternationalFormat []string

+ LeadingDigits []string

+ NationalPrefixFormattingRule string

+ NationalPrefixOptionalWhenFormatting *bool

+ Pattern string

+ type Numbers struct

+ DefaultPrefix string

+ PhoneOnly bool

+ PhoneTypes []string

+ Phones []string

+ func (p *Numbers) Clean() (VerifiedNumbers, UnverifiedNumbers)

+ func (p *Numbers) StatsByCarrier() CarrierStats

+ func (p *Numbers) StatsByCountry() CountryStats

+ func (p *Numbers) Verify() VerifiedNumbers

+ type Ops struct

+ Alias string

+ Field string

+ Operator string

+ Raw string

+ Value string

+ type PhoneMetadata struct

+ CarrierSpecific *PhoneNumberDesc

+ CountryCode *int32

+ Emergency *PhoneNumberDesc

+ FixedLine *PhoneNumberDesc

+ GeneralDesc *PhoneNumberDesc

+ Id *string

+ InternationalPrefix *string

+ IntlNumberFormat []*NumberFormat

+ LeadingDigits *string

+ LeadingZeroPossible *bool

+ MainCountryForCode *bool

+ Mobile *PhoneNumberDesc

+ MobileNumberPortableRegion *bool

+ NationalPrefix *string

+ NationalPrefixForParsing *string

+ NationalPrefixTransformRule *string

+ NoInternationalDialling *PhoneNumberDesc

+ NumberFormat []*NumberFormat

+ Pager *PhoneNumberDesc

+ PersonalNumber *PhoneNumberDesc

+ PreferredExtnPrefix *string

+ PreferredInternationalPrefix *string

+ PremiumRate *PhoneNumberDesc

+ SameMobileAndFixedLinePattern *bool

+ SharedCost *PhoneNumberDesc

+ ShortCode *PhoneNumberDesc

+ SmsServices *PhoneNumberDesc

+ StandardRate *PhoneNumberDesc

+ TollFree *PhoneNumberDesc

+ Uan *PhoneNumberDesc

+ Voicemail *PhoneNumberDesc

+ Voip *PhoneNumberDesc

+ func (*PhoneMetadata) Descriptor() ([]byte, []int)

+ func (*PhoneMetadata) ProtoMessage()

+ func (x *PhoneMetadata) GetCarrierSpecific() *PhoneNumberDesc

+ func (x *PhoneMetadata) GetCountryCode() int32

+ func (x *PhoneMetadata) GetEmergency() *PhoneNumberDesc

+ func (x *PhoneMetadata) GetFixedLine() *PhoneNumberDesc

+ func (x *PhoneMetadata) GetGeneralDesc() *PhoneNumberDesc

+ func (x *PhoneMetadata) GetId() string

+ func (x *PhoneMetadata) GetInternationalPrefix() string

+ func (x *PhoneMetadata) GetIntlNumberFormat() []*NumberFormat

+ func (x *PhoneMetadata) GetLeadingDigits() string

+ func (x *PhoneMetadata) GetLeadingZeroPossible() bool

+ func (x *PhoneMetadata) GetMainCountryForCode() bool

+ func (x *PhoneMetadata) GetMobile() *PhoneNumberDesc

+ func (x *PhoneMetadata) GetMobileNumberPortableRegion() bool

+ func (x *PhoneMetadata) GetNationalPrefix() string

+ func (x *PhoneMetadata) GetNationalPrefixForParsing() string

+ func (x *PhoneMetadata) GetNationalPrefixTransformRule() string

+ func (x *PhoneMetadata) GetNoInternationalDialling() *PhoneNumberDesc

+ func (x *PhoneMetadata) GetNumberFormat() []*NumberFormat

+ func (x *PhoneMetadata) GetPager() *PhoneNumberDesc

+ func (x *PhoneMetadata) GetPersonalNumber() *PhoneNumberDesc

+ func (x *PhoneMetadata) GetPreferredExtnPrefix() string

+ func (x *PhoneMetadata) GetPreferredInternationalPrefix() string

+ func (x *PhoneMetadata) GetPremiumRate() *PhoneNumberDesc

+ func (x *PhoneMetadata) GetSameMobileAndFixedLinePattern() bool

+ func (x *PhoneMetadata) GetSharedCost() *PhoneNumberDesc

+ func (x *PhoneMetadata) GetShortCode() *PhoneNumberDesc

+ func (x *PhoneMetadata) GetSmsServices() *PhoneNumberDesc

+ func (x *PhoneMetadata) GetStandardRate() *PhoneNumberDesc

+ func (x *PhoneMetadata) GetTollFree() *PhoneNumberDesc

+ func (x *PhoneMetadata) GetUan() *PhoneNumberDesc

+ func (x *PhoneMetadata) GetVoicemail() *PhoneNumberDesc

+ func (x *PhoneMetadata) GetVoip() *PhoneNumberDesc

+ func (x *PhoneMetadata) ProtoReflect() protoreflect.Message

+ func (x *PhoneMetadata) Reset()

+ func (x *PhoneMetadata) String() string

+ type PhoneMetadataCollection struct

+ Metadata []*PhoneMetadata

+ func BuildAlternateFormatsMetadataCollection(inputXML []byte) (*PhoneMetadataCollection, error)

+ func BuildPhoneMetadataCollection(inputXML []byte, liteBuild bool, specialBuild bool, isShortNumberMetadata bool) (*PhoneMetadataCollection, error)

+ func MetadataCollection() (*PhoneMetadataCollection, error)

+ func ShortNumberMetadataCollection() (*PhoneMetadataCollection, error)

+ func (*PhoneMetadataCollection) Descriptor() ([]byte, []int)

+ func (*PhoneMetadataCollection) ProtoMessage()

+ func (x *PhoneMetadataCollection) GetMetadata() []*PhoneMetadata

+ func (x *PhoneMetadataCollection) ProtoReflect() protoreflect.Message

+ func (x *PhoneMetadataCollection) Reset()

+ func (x *PhoneMetadataCollection) String() string

+ type PhoneNumber struct

+ CountryCode *int32

+ CountryCodeSource *PhoneNumber_CountryCodeSource

+ Extension *string

+ ItalianLeadingZero *bool

+ NationalNumber *uint64

+ NumberOfLeadingZeros *int32

+ PreferredDomesticCarrierCode *string

+ RawInput *string

+ func GetExampleNumber(regionCode string) *PhoneNumber

+ func GetExampleNumberForNonGeoEntity(countryCallingCode int) *PhoneNumber

+ func GetExampleNumberForType(regionCode string, typ PhoneNumberType) *PhoneNumber

+ func GetInvalidExampleNumber(regionCode string) *PhoneNumber

+ func Parse(numberToParse, defaultRegion string) (*PhoneNumber, error)

+ func ParseAndKeepRawInput(numberToParse, defaultRegion string) (*PhoneNumber, error)

+ func (*PhoneNumber) Descriptor() ([]byte, []int)

+ func (*PhoneNumber) ProtoMessage()

+ func (x *PhoneNumber) GetCountryCode() int32

+ func (x *PhoneNumber) GetCountryCodeSource() PhoneNumber_CountryCodeSource

+ func (x *PhoneNumber) GetExtension() string

+ func (x *PhoneNumber) GetItalianLeadingZero() bool

+ func (x *PhoneNumber) GetNationalNumber() uint64

+ func (x *PhoneNumber) GetNumberOfLeadingZeros() int32

+ func (x *PhoneNumber) GetPreferredDomesticCarrierCode() string

+ func (x *PhoneNumber) GetRawInput() string

+ func (x *PhoneNumber) ProtoReflect() protoreflect.Message

+ func (x *PhoneNumber) Reset()

+ func (x *PhoneNumber) String() string

+ type PhoneNumberDesc struct

+ ExampleNumber *string

+ NationalNumberPattern *string

+ PossibleLength []int32

+ PossibleLengthLocalOnly []int32

+ func (*PhoneNumberDesc) Descriptor() ([]byte, []int)

+ func (*PhoneNumberDesc) ProtoMessage()

+ func (x *PhoneNumberDesc) GetExampleNumber() string

+ func (x *PhoneNumberDesc) GetNationalNumberPattern() string

+ func (x *PhoneNumberDesc) GetPossibleLength() []int32

+ func (x *PhoneNumberDesc) GetPossibleLengthLocalOnly() []int32

+ func (x *PhoneNumberDesc) ProtoReflect() protoreflect.Message

+ func (x *PhoneNumberDesc) Reset()

+ func (x *PhoneNumberDesc) String() string

+ type PhoneNumberDescE struct

+ ExampleNumber string

+ NationalNumberPattern string

+ PossibleLengths *PossibleLengthE

+ type PhoneNumberFormat int

+ const E164

+ const INTERNATIONAL

+ const NATIONAL

+ const RFC3966

+ type PhoneNumberMatch struct

+ func (m *PhoneNumberMatch) End() int

+ func (m *PhoneNumberMatch) Number() *PhoneNumber

+ func (m *PhoneNumberMatch) RawString() string

+ func (m *PhoneNumberMatch) Start() int

+ func (m *PhoneNumberMatch) String() string

+ type PhoneNumberMetadataE struct

+ Territories []TerritoryE

+ type PhoneNumberType int

+ const FIXED_LINE

+ const FIXED_LINE_OR_MOBILE

+ const MOBILE

+ const PAGER

+ const PERSONAL_NUMBER

+ const PREMIUM_RATE

+ const SHARED_COST

+ const TOLL_FREE

+ const UAN

+ const UNKNOWN

+ const VOICEMAIL

+ const VOIP

+ func GetNumberType(number *PhoneNumber) PhoneNumberType

+ type PhoneNumber_CountryCodeSource int32

+ const PhoneNumber_FROM_DEFAULT_COUNTRY

+ const PhoneNumber_FROM_NUMBER_WITHOUT_PLUS_SIGN

+ const PhoneNumber_FROM_NUMBER_WITH_IDD

+ const PhoneNumber_FROM_NUMBER_WITH_PLUS_SIGN

+ const PhoneNumber_UNSPECIFIED

+ func (PhoneNumber_CountryCodeSource) Descriptor() protoreflect.EnumDescriptor

+ func (PhoneNumber_CountryCodeSource) EnumDescriptor() ([]byte, []int)

+ func (PhoneNumber_CountryCodeSource) Type() protoreflect.EnumType

+ func (x *PhoneNumber_CountryCodeSource) UnmarshalJSON(b []byte) error

+ func (x PhoneNumber_CountryCodeSource) Enum() *PhoneNumber_CountryCodeSource

+ func (x PhoneNumber_CountryCodeSource) Number() protoreflect.EnumNumber

+ func (x PhoneNumber_CountryCodeSource) String() string

+ type PossibleLengthE struct

+ LocalOnly string

+ National string

+ type Query struct

+ Fields []string

+ GroupBy []string

+ Operations []Ops

+ Raw string

+ type ShortNumberCost int

+ const PREMIUM_RATE_COST

+ const STANDARD_RATE_COST

+ const TOLL_FREE_COST

+ const UNKNOWN_COST

+ func GetExpectedCost(number *PhoneNumber) ShortNumberCost

+ func GetExpectedCostForRegion(number *PhoneNumber, regionDialingFrom string) ShortNumberCost

+ func (c ShortNumberCost) String() string

+ type StringBuilder struct

+ func NewStringBuilder(buf []byte) *StringBuilder

+ func NewStringBuilderString(s string) *StringBuilder

+ func (b *StringBuilder) ByteAt(i int) (byte, error)

+ func (b *StringBuilder) Bytes() []byte

+ func (b *StringBuilder) Insert(i int, p []byte) (int, error)

+ func (b *StringBuilder) InsertString(i int, s string) (int, error)

+ func (b *StringBuilder) Len() int

+ func (b *StringBuilder) Reset()

+ func (b *StringBuilder) ResetWith(buf []byte) (int, error)

+ func (b *StringBuilder) ResetWithString(s string) (int, error)

+ func (b *StringBuilder) String() string

+ func (b *StringBuilder) Write(p []byte) (int, error)

+ func (b *StringBuilder) WriteByte(c byte) error

+ func (b *StringBuilder) WriteRune(r rune) (int, error)

+ func (b *StringBuilder) WriteString(s string) (int, error)

+ type TerritoryE struct

+ AvailableFormats []NumberFormatE

+ CarrierCodeFormattingRule string

+ CarrierSpecific *PhoneNumberDescE

+ CountryCode int32

+ Emergency *PhoneNumberDescE

+ FixedLine *PhoneNumberDescE

+ GeneralDesc *PhoneNumberDescE

+ ID string

+ InternationalPrefix string

+ LeadingDigits string

+ MainCountryForCode bool

+ Mobile *PhoneNumberDescE

+ MobileNumberPortableRegion bool

+ NationalPrefix string

+ NationalPrefixForParsing string

+ NationalPrefixFormattingRule string

+ NationalPrefixOptionalWhenFormatting bool

+ NationalPrefixTransformRule string

+ NoInternationalDialing *PhoneNumberDescE

+ Pager *PhoneNumberDescE

+ PersonalNumber *PhoneNumberDescE

+ PreferredExtnPrefix string

+ PreferredInternationalPrefix string

+ PremiumRate *PhoneNumberDescE

+ References []string

+ SharedCost *PhoneNumberDescE

+ ShortCode *PhoneNumberDescE

+ SmsServices *PhoneNumberDescE

+ StandardRate *PhoneNumberDescE

+ TollFree *PhoneNumberDescE

+ UAN *PhoneNumberDescE

+ VOIP *PhoneNumberDescE

+ VoiceMail *PhoneNumberDescE

+ type UnverifiedNumbers struct

+ Phones []string

+ type ValidationResult int

+ const INVALID_COUNTRY_CODE

+ const INVALID_LENGTH

+ const IS_POSSIBLE

+ const IS_POSSIBLE_LOCAL_ONLY

+ const TOO_LONG

+ const TOO_SHORT

+ func IsPossibleNumberForTypeWithReason(number *PhoneNumber, numberType PhoneNumberType) ValidationResult

+ func IsPossibleNumberWithReason(number *PhoneNumber) ValidationResult

+ type VerifiedNumbers struct

+ DefaultPrefix string

+ PhoneTypes []string

+ Phones []Number

+ func VerifyList(phone []string, defaultRegion ...string) VerifiedNumbers

v0.0.6

Oct 18, 2025

v0.0.5

Dec 12, 2023

v0.0.4

Dec 12, 2023

v0.0.3

Nov 26, 2023

v0.0.2

Nov 14, 2023

v0.0.1

Mar 21, 2023