[rac] Download all rules for a country code in libaddressinput.

third_party/libaddressinput/chromium/cpp/src/rule_retriever.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,
 // 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.
 //
 // An object to retrieve validation rules.
 
 #ifndef I18N_ADDRESSINPUT_RULE_RETRIEVER_H_
 #define I18N_ADDRESSINPUT_RULE_RETRIEVER_H_
 
 #include <libaddressinput/callback.h>
 #include <libaddressinput/util/basictypes.h>
 #include <libaddressinput/util/scoped_ptr.h>
 
-#include <string>
-
 namespace i18n {
 namespace addressinput {
 
+class LookupKey;
 class Retriever;
 class Rule;
 
 // Retrieves validation rules. Sample usage:
 //    const Retriever* retriever = ...
 //    RuleRetriever rules(retriever);
 //    scoped_ptr<RuleRetriever::Callback> rule_ready(BuildCallback(
 //        this, &MyClass::OnRuleReady));
-//    rules.RetrieveRule("data/CA/AB--fr", *rule_ready);
+//    LookupKey key("US");
+//    rules.RetrieveRule(key, *rule_ready);
 class RuleRetriever {
  public:
-  typedef i18n::addressinput::Callback<std::string, Rule> Callback;
+  typedef i18n::addressinput::Callback<LookupKey, Rule> Callback;
 
   // Takes ownership of |retriever|.
   explicit RuleRetriever(const Retriever* retriever);
   ~RuleRetriever();
 
   // Retrieves the rule for |key| and invokes the |rule_ready| callback.
-  void RetrieveRule(const std::string& key, const Callback& rule_ready) const;
+  void RetrieveRule(const LookupKey& key, const Callback& rule_ready) const;
 
  private:
   scoped_ptr<const Retriever> data_retriever_;
 
   DISALLOW_COPY_AND_ASSIGN(RuleRetriever);
 };
 
 }  // namespace addressinput
 }  // namespace i18n
 
 #endif  // I18N_ADDRESSINPUT_RULE_RETRIEVER_H_