chrome/browser/language_usage_metrics.h

   1 // Copyright (c) 2011 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4
   5 #ifndef CHROME_BROWSER_LANGUAGE_USAGE_METRICS_H_
   6 #define CHROME_BROWSER_LANGUAGE_USAGE_METRICS_H_
   7
   8 #include <set>
   9 #include <string>
  10
  11 #include "base/basictypes.h"
  12 #include "base/gtest_prod_util.h"
  13
  14 // Methods to record language usage as UMA histograms.
  15 class LanguageUsageMetrics {
  16  public:
  17   // Records accept languages as a UMA histogram. |accept_languages| is a
  18   // case-insensitive comma-separated list of languages/locales of either xx,
  19   // xx-YY, or xx_YY format where xx is iso-639 language code and YY is iso-3166
  20   // country code. Country code is ignored. That is, xx and XX-YY are considered
  21   // identical and recorded once.
  22   static void RecordAcceptLanguages(const std::string& accept_languages);
  23
  24   // Records the application language as a UMA histogram. |application_locale|
  25   // is a case-insensitive locale string of either xx, xx-YY, or xx_YY format.
  26   // Only the language part (xx in the example) is considered.
  27   static void RecordApplicationLanguage(const std::string& application_locale);
  28
  29   // Parses |locale| and returns the language code. Returns 0 in case of errors.
  30   // The language code is calculated from two alphabets. For example, if
  31   // |locale| is 'en' which represents 'English', the codes of 'e' and 'n' are
  32   // 101 and 110 respectively, and the language code will be 101 * 256 + 100 =
  33   // 25966.
  34   // |locale| should consist of only lower-case letters. This function doesn't
  35   // check whether |locale| is valid locale or not strictly.
  36   static int ToLanguageCode(const std::string &locale);
  37
  38  private:
  39   DISALLOW_IMPLICIT_CONSTRUCTORS(LanguageUsageMetrics);
  40
  41   // Parses |accept_languages| and returns a set of language codes in
  42   // |languages|.
  43   static void ParseAcceptLanguages(const std::string& accept_languages,
  44                                    std::set<int>* languages);
  45
  46   FRIEND_TEST_ALL_PREFIXES(LanguageUsageMetricsTest, ParseAcceptLanguages);
  47 };
  48
  49 #endif  // CHROME_BROWSER_LANGUAGE_USAGE_METRICS_H_