[rac] Validate an address.

third_party/libaddressinput/chromium/cpp/src/lookup_key.h

 // Copyright (C) 2013 Google Inc.
 //
 // 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,
@@ skipping 27 matching lines @@
 #include <libaddressinput/util/basictypes.h>
 #include <libaddressinput/util/scoped_ptr.h>
 
 #include <map>
 #include <string>
 
 namespace i18n {
 namespace addressinput {
 
 class Rule;
+struct AddressData;
 
 // Stores a parsed validation rule, its identifier, and its level. Sample usage:
 //    LookupKey country_key("CA");
 //    Rule country_rule = RetrieveRule(country_key.GetKeyValue());
 //    country_key.SetRule(country_rule);
 //
 //    LookupKey* administrative_area_key = country_key.AddSubKey("AB");
 //    administrative_area_key->SetRule(
 //        RetrieveRule(administrative_area_key.GetKeyValue()));
 //
@@ skipping 31 matching lines @@
   const Rule* GetRule() const;
 
   // Adds a sub-LookupKey for |sub_region| and returns it. The caller does not
   // own the result.
   LookupKey* AddSubKey(const std::string& sub_region);
 
   // Adds a sub-LookupKey for |language_code| key and returns it. The caller
   // does not own the result.
   LookupKey* AddLanguageCodeKey(const std::string& language_code);
 
   // Returns the lookup key for |sub_region| or NULL. The caller does not own

[Evan Stade, 2013/12/19 02:12:38]

explain when it may return NULL

[please use gerrit instead, 2014/01/08 00:55:52]

Done.

   // the result.
-  LookupKey* GetSubKey(const std::string& sub_key) const;
+  const LookupKey* GetSubKey(const std::string& sub_region) const;
 
   // Returns the lookup key for |language_code| or NULL. The caller does not own

[Evan Stade, 2013/12/19 02:12:38]

explain when it may return NULL

[please use gerrit instead, 2014/01/08 00:55:52]

Done.

   // the result.
-  LookupKey* GetLanguageCodeKey(const std::string& language_code) const;
+  const LookupKey* GetLanguageCodeKey(const std::string& language_code) const;
+
+  // Builds a mapping of address fields to corresponding parsed validation rules
+  // for |address|. The caller does not own the returned Rule objects. For
+  // example, if the address is "Calgary, Alberta, Canada" with "fr" language
+  // code, then returns the rules for "data/CA--fr" and "data/CA/AB--fr".
+  std::map<AddressField, const Rule*> BuildFieldRuleMap(
+      const AddressData& address) const;
 
  private:
   // A mapping of string identifiers to LookupKey objects. A string identifier
   // can be either a language code (e.g., "fr", "de", it") or a sub-region
   // identifier (e.g., "NY", "TX", "CA").
   typedef std::map<std::string, LookupKey*> LookupKeys;
 
   // Builds a lookup key with identifier |key_value| at the given |level|.
   LookupKey(const std::string& key_value, AddressField level);
 
@@ skipping 13 matching lines @@
   // language codes.
   LookupKeys language_code_keys_;
 
   DISALLOW_COPY_AND_ASSIGN(LookupKey);
 };
 
 }  // namespace addressinput
 }  // namespace i18n
 
 #endif  // I18N_ADDRESSINPUT_LOOKUP_KEY_H_