URL Formatter: Add StripSubdomain method that preserves eTLD + 1.

components/url_formatter/url_formatter.h

 // Copyright 2015 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.
 
 // url_formatter contains routines for formatting URLs in a way that can be
 // safely and securely displayed to users. For example, it is responsible
 // for determining when to convert an IDN A-Label (e.g. "xn--[something]")
 // into the IDN U-Label.
 //
 // Note that this formatting is only intended for display purposes; it would
@@ skipping 119 matching lines @@
 
 // Converts the given host name to unicode characters. This can be called for
 // any host name, if the input is not IDN or is invalid in some way, we'll just
 // return the ASCII source so it is still usable.
 //
 // The input should be the canonicalized ASCII host name from GURL. This
 // function does NOT accept UTF-8!
 base::string16 IDNToUnicode(base::StringPiece host);
 
 // If |text| starts with "www." it is removed, otherwise |text| is returned
-// unmodified.
+// unmodified. Both |text| and the returned value are arbitrary strings and
+// are not guaranteed to be navigable hostnames.
 base::string16 StripWWW(const base::string16& text);
 
-// Runs |url|'s host through StripWWW().  |url| must be valid.
-base::string16 StripWWWFromHost(const GURL& url);
+// Returns the host of |url| with subdomains specified by |subdomains|
+// removed. |url| must be valid. If the |url| host is already an eTLD+1,
+// the host is returned unmodified.
+typedef uint32_t StripSubdomainType;
+typedef uint32_t StripSubdomainTypes;
+constexpr StripSubdomainType kStripWWW = 1 << 0;
+constexpr StripSubdomainType kStripM = 1 << 1;
+std::string StripSubdomains(const GURL& url, StripSubdomainTypes subdomains);
 
 }  // namespace url_formatter
 
 #endif  // COMPONENTS_URL_FORMATTER_URL_FORMATTER_H_