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

components/url_formatter/url_formatter.h

Index: components/url_formatter/url_formatter.h
diff --git a/components/url_formatter/url_formatter.h b/components/url_formatter/url_formatter.h
index 90f2bbf9b73128e35a080382b35fe91d08db3d09..0f0eb683795224ab926e2c2c617c6588711ce5fe 100644
--- a/components/url_formatter/url_formatter.h
+++ b/components/url_formatter/url_formatter.h
@@ -137,11 +137,18 @@ void AppendFormattedHost(const GURL& url, base::string16* output);
 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