Use upstream libaddressinput in Chrome.

third_party/libaddressinput/chromium/suggestions.h

+// Copyright 2014 The Chromium Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
+
+#ifndef THIRD_PARTY_LIBADDRESSINPUT_CHROMIUM_SUGGESTIONS_H_
+#define THIRD_PARTY_LIBADDRESSINPUT_CHROMIUM_SUGGESTIONS_H_
+
+#include <vector>
+
+#include "base/basictypes.h"
+#include "base/memory/scoped_ptr.h"
+#include "third_party/libaddressinput/src/cpp/include/libaddressinput/address_field.h"
+
+namespace i18n {
+namespace addressinput {
+class PreloadSupplier;
+struct AddressData;
+}
+}
+
+namespace autofill {
+
+class Suggestions {

[Evan Stade, 2014/06/12 00:18:09]

class level comment

better class name needed. Most class names describe what they do, not what they
return. Hence InputSuggester, InputAssistant, etc.

[please use gerrit instead, 2014/06/13 19:22:09]

Done.

+ public:
+  // Does not take ownership of |supplier|, which should not be NULL.
+  explicit Suggestions(::i18n::addressinput::PreloadSupplier* supplier);
+  ~Suggestions();
+
+  // Fills in |suggestions| for the partially typed in |user_input|, assuming
+  // the user is typing in the |focused_field|. If the number of |suggestions|
+  // is over the |suggestion_limit|, then returns no |suggestions| at all.
+  //
+  // Sample user input 1:
+  //   country code = "US"
+  //   postal code = "90066"
+  //   focused field = POSTAL_CODE
+  //   suggestions limit = 1
+  // Suggestion:
+  //   [{administrative_area: "CA"}]
+  //
+  // Sample user input 2:
+  //   country code = "CN"
+  //   dependent locality = "Zongyang"
+  //   focused field = DEPENDENT_LOCALITY
+  //   suggestions limit = 10
+  // Suggestion:
+  //   [{dependent_locality: "Zongyang Xian",
+  //     locality: "Anqing Shi",
+  //     administrative_area: "Anhui Sheng"}]
+  //
+  // Builds the index for generating suggestions lazily.
+  //
+  // The |suggestions| parameter should not be NULL. The |focused_field|
+  // parameter should be either POSTAL_CODE or between ADMIN_AREA and
+  // DEPENDENT_LOCALITY inclusively.
+  void GetSuggestions(
+      const ::i18n::addressinput::AddressData& user_input,
+      ::i18n::addressinput::AddressField focused_field,
+      size_t suggestion_limit,
+      std::vector< ::i18n::addressinput::AddressData>* suggestions);
+
+ private:
+  class TrieCollection;
+
+  // A collection of tries for generating suggestions.
+  scoped_ptr<TrieCollection> trie_collection_;
+
+  DISALLOW_COPY_AND_ASSIGN(Suggestions);
+};
+
+}  // namespace autofill
+
+#endif  // THIRD_PARTY_LIBADDRESSINPUT_CHROMIUM_SUGGESTIONS_H_