[rac] Format an address for display.

third_party/libaddressinput/chromium/cpp/include/libaddressinput/address_data.h

Index: third_party/libaddressinput/chromium/cpp/include/libaddressinput/address_data.h
diff --git a/third_party/libaddressinput/chromium/cpp/include/libaddressinput/address_data.h b/third_party/libaddressinput/chromium/cpp/include/libaddressinput/address_data.h
index 8c8b75e316af5d7e139d105c866c283971981de3..7224d48233cd64dfcf76d73fe55743136e4b6d7f 100644
--- a/third_party/libaddressinput/chromium/cpp/include/libaddressinput/address_data.h
+++ b/third_party/libaddressinput/chromium/cpp/include/libaddressinput/address_data.h
@@ -29,16 +29,25 @@ namespace addressinput {
 
 // Stores an address. Sample usage:
 //    AddressData address;
-//    address.country_code = "US";
+//    address.recipient = "Chen-Kang Yang";
+//    address.organization = "Google";
 //    address.address_lines.push_back("1098 Alta Ave");
 //    address.administrative_area = "CA";
 //    address.locality = "Mountain View";
 //    address.postal_code = "94043";
-//    address.organization = "Google";
-//    address.recipient = "Chen-Kang Yang";
+//    address.country_code = "US";
 //    address.language_code = "en";
 //    Process(address);
 struct AddressData {
+  // Clears |lines| and populates it with the lines of the address as they
+  // should appear on an envelope for |contry_code|. The |lines| parameter
+  // should not be NULL.
+  //
+  // If there're no address formatting rules for |country_code|, then the
+  // default rules are used:
+  // https://i18napis.appspot.com/ssl-address/data/ZZ
+  void BuildDisplayLines(std::vector<std::string>* lines) const;
+
   // Returns the value of the |field|. The parameter should not be
   // STREET_ADDRESS, which comprises multiple fields.
   const std::string& GetField(AddressField field) const;