[rac] Validate an address.

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

 // Copyright (C) 2014 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.
 
 #ifndef I18N_ADDRESSINPUT_RULESET_H_
 #define I18N_ADDRESSINPUT_RULESET_H_
 
+#include <libaddressinput/address_field.h>
 #include <libaddressinput/util/basictypes.h>
 #include <libaddressinput/util/scoped_ptr.h>
 
 #include <map>
 #include <string>
 
 namespace i18n {
 namespace addressinput {
 
+class AddressData;
 class Rule;
 
 // A recursive data structure that stores a set of rules for a region. Can store
 // the rules for a country, its administrative areas, localities, and dependent
 // localities, in addition to the language-specific rules.
 //
 // Example for Canada and some of its provinces:
 //                   CA-->fr
 //                   |
 // -------------------------------------
@@ skipping 14 matching lines @@
   // Returns the region-wide rule in the default language of the country.
   const Rule& rule() const { return *rule_.get(); }
 
   // Adds and returns a ruleset for |sub_region| with the subregion-wide |rule|
   // in the default language of the country. The caller does not own the result.
   Ruleset* AddSubRegion(const std::string& sub_region, scoped_ptr<Rule> rule);
 
   // Adds a language-specific |rule| for |language_code| for this region.
   void AddLanguageCode(const std::string& language_code, scoped_ptr<Rule> rule);
 
-  // Returns the set of rules for |sub_region|. The result can be NULL. The
-  // caller does not own the result.
+  // Returns the set of rules for |sub_region|. The result is NULL if there's no
+  // such |sub_region|. The caller does not own the result.
   Ruleset* GetSubRegion(const std::string& sub_region) const;
 
-  // Returns the language-specific rule for |language_code|. The result can be
-  // NULL. The caller does not own the result.
+  // Returns the language-specific rule for |language_code|. The result is NULL
+  // if there's no such |language_code|. The caller does not own the result.
   const Rule* GetLanguageCode(const std::string& language_code) const;
 
+  // Returns a mapping of field types to validation rules based on the field
+  // values in |address|. Should be invoked only on a root ruleset (at country
+  // level).
+  std::map<AddressField, const Rule*> BuildRulesForAddress(
+      const AddressData& address) const;
+
  private:
   // The region-wide rule in the default language of the country.
   scoped_ptr<const Rule> rule_;
 
   // Owned rulesets for sub-regions.
   std::map<std::string, Ruleset*> sub_regions_;
 
   // Owned language-specific rules for the region.
   std::map<std::string, const Rule*> language_codes_;
 
   DISALLOW_COPY_AND_ASSIGN(Ruleset);
 };
 
 }  // namespace addressinput
 }  // namespace i18n
 
 #endif  // I18N_ADDRESSINPUT_RULESET_H_