You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
79 lines
2.6 KiB
79 lines
2.6 KiB
// Copyright (C) 2012 The Libphonenumber Authors
|
|
//
|
|
// Licensed under the Apache License, Version 2.0 (the "License");
|
|
// you may not use this file except in compliance with the License.
|
|
// You may obtain a copy of the License at
|
|
//
|
|
// http://www.apache.org/licenses/LICENSE-2.0
|
|
//
|
|
// Unless required by applicable law or agreed to in writing, software
|
|
// distributed under the License is distributed on an "AS IS" BASIS,
|
|
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
// See the License for the specific language governing permissions and
|
|
// limitations under the License.
|
|
//
|
|
// Author: Patrick Mezard
|
|
|
|
#ifndef I18N_PHONENUMBERS_AREA_CODE_MAP_H_
|
|
#define I18N_PHONENUMBERS_AREA_CODE_MAP_H_
|
|
|
|
#include <cstdint>
|
|
#include <map>
|
|
#include <string>
|
|
|
|
#include "phonenumbers/base/basictypes.h"
|
|
#include "phonenumbers/base/memory/scoped_ptr.h"
|
|
|
|
namespace i18n {
|
|
namespace phonenumbers {
|
|
|
|
using std::map;
|
|
using std::string;
|
|
|
|
class DefaultMapStorage;
|
|
class PhoneNumber;
|
|
class PhoneNumberUtil;
|
|
struct PrefixDescriptions;
|
|
|
|
// A utility that maps phone number prefixes to a string describing the
|
|
// geographical area the prefix covers.
|
|
class AreaCodeMap {
|
|
public:
|
|
AreaCodeMap();
|
|
|
|
// This type is neither copyable nor movable.
|
|
AreaCodeMap(const AreaCodeMap&) = delete;
|
|
AreaCodeMap& operator=(const AreaCodeMap&) = delete;
|
|
|
|
~AreaCodeMap();
|
|
|
|
// Returns the description of the geographical area the number corresponds
|
|
// to. This method distinguishes the case of an invalid prefix and a prefix
|
|
// for which the name is not available in the current language. If the
|
|
// description is not available in the current language an empty string is
|
|
// returned. If no description was found for the provided number, null is
|
|
// returned.
|
|
const char* Lookup(const PhoneNumber& number) const;
|
|
|
|
// Creates an AreaCodeMap initialized with area_codes. Note that the
|
|
// underlying implementation of this method is expensive thus should
|
|
// not be called by time-critical applications.
|
|
//
|
|
// area_codes maps phone number prefixes to geographical area description.
|
|
void ReadAreaCodeMap(const PrefixDescriptions* descriptions);
|
|
|
|
private:
|
|
// Does a binary search for value in the provided array from start to end
|
|
// (inclusive). Returns the position if {@code value} is found; otherwise,
|
|
// returns the position which has the largest value that is less than value.
|
|
// This means if value is the smallest, -1 will be returned.
|
|
int BinarySearch(int start, int end, int64_t value) const;
|
|
|
|
const PhoneNumberUtil& phone_util_;
|
|
scoped_ptr<const DefaultMapStorage> storage_;
|
|
};
|
|
|
|
} // namespace phonenumbers
|
|
} // namespace i18n
|
|
|
|
#endif /* I18N_PHONENUMBERS_AREA_CODE_MAP_H_ */
|