// Copyright (c) 2010, Amar Takhar <verm@aegisub.org>
//
// Permission to use, copy, modify, and distribute this software for any
// purpose with or without fee is hereby granted, provided that the above
// copyright notice and this permission notice appear in all copies.
//
// THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
// WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
// MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
// ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
// WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
// ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
// OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

#include <libaegisub/fs.h>
#include <string>

namespace agi {
	/// Character set conversion and detection.
	namespace charset {

enum class DetectReason {
	Signature,
	SizeHeuristic,
	BinaryHeuristic,
	ValidUtf8,
	Uchardet,
	Utf8Fallback,
};

/// @brief Returns the character set with the highest confidence
/// @param file File to check
/// @param reason If not null, the reason for detection will be stored there
/// @return Detected character set.
std::string Detect(agi::fs::path const& file, DetectReason *reason = nullptr);

	} // namespace util
} // namespace agi
