base/i18n/icu_encoding_detection.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 BASE_I18N_ICU_ENCODING_DETECTION_H_
   6 #define BASE_I18N_ICU_ENCODING_DETECTION_H_
   7
   8 #include <string>
   9 #include <vector>
  10
  11 #include "base/i18n/base_i18n_export.h"
  12
  13 namespace base {
  14
  15 // Detect encoding of |text| and put the name of encoding (as returned by ICU)
  16 // in |encoding|. For ASCII texts |encoding| will be set to an empty string.
  17 // Returns true on success.
  18 BASE_I18N_EXPORT bool DetectEncoding(const std::string& text,
  19                                      std::string* encoding);
  20
  21 // Detect all possible encodings of |text| and put their names
  22 // (as returned by ICU) in |encodings|. Returns true on success.
  23 // Note: this function may return encodings that may fail to decode |text|,
  24 // the caller is responsible for handling that.
  25 BASE_I18N_EXPORT bool DetectAllEncodings(const std::string& text,
  26                                          std::vector<std::string>* encodings);
  27
  28 }  // namespace base
  29
  30 #endif  // BASE_I18N_ICU_ENCODING_DETECTION_H_