using System.Text;

namespace Developpez.Dotnet.Text
{
    /// <summary>
    /// Fournit des méthodes d'extension pour travailler avec les encodages de texte
    /// </summary>
    public static class EncodingExtensions
    {
        /// <summary>
        /// Tente de décoder une chaine de caractères à partir d'un tableau d'octets pour un encodage donné.
        /// </summary>
        /// <param name="encoding">Encodage à utiliser pour le décodage</param>
        /// <param name="bytes">Tableau d'octets contenant les données à décoder</param>
        /// <param name="result">Chaine décodée</param>
        /// <returns>True si le décodage réussit, false si <c>bytes</c> contient des donnés non valides</returns>
        public static bool TryGetString(this Encoding encoding, byte[] bytes, out string result)
        {
            return encoding.TryGetString(bytes, 0, bytes.Length, out result);
        }

        /// <summary>
        /// Tente de décoder une chaine de caractères à partir d'un tableau d'octets pour un encodage donné.
        /// </summary>
        /// <param name="encoding">Encodage à utiliser pour le décodage</param>
        /// <param name="bytes">Tableau d'octets contenant les données à décoder</param>
        /// <param name="result">Chaine décodée</param>
        /// <param name="index">Position à partir de laquelle on lit les données</param>
        /// <param name="count">Nombre d'octets à lire</param>
        /// <returns>True si le décodage réussit, false si <c>bytes</c> contient des donnés non valides</returns>
        public static bool TryGetString(this Encoding encoding, byte[] bytes, int index, int count, out string result)
        {
            result = null;
            try
            {
                var decoder = encoding.GetDecoder();
                decoder.Fallback = DecoderFallback.ExceptionFallback;
                int charCount = decoder.GetCharCount(bytes, index, count);
                char[] chars = new char[charCount];
                decoder.GetChars(bytes, index, count, chars, 0);
                result = new string(chars);
                return true;
            }
            catch(DecoderFallbackException)
            {
                return false;
            }
        }

        /// <summary>
        /// Vérifie si un tableau d'octets contient des données valides pour un encodage donné.
        /// </summary>
        /// <param name="encoding">Encodage pour lequel la validité des données est vérifiée</param>
        /// <param name="bytes">Tableau d'octets contenant les données à vérifier</param>
        /// <returns>True si les données sont valides, sinon false.</returns>
        public static bool IsValid(this Encoding encoding, byte[] bytes)
        {
            return encoding.IsValid(bytes, 0, bytes.Length);
        }

        /// <summary>
        /// Vérifie si un tableau d'octets contient des données valides pour un encodage donné.
        /// </summary>
        /// <param name="encoding">Encodage pour lequel la validité des données est vérifiée</param>
        /// <param name="bytes">Tableau d'octets contenant les données à vérifier</param>
        /// <param name="index">Position à partir de laquelle on vérifie les données</param>
        /// <param name="count">Nombre d'octets à vérifier</param>
        /// <returns>True si les données sont valides, sinon false.</returns>
        public static bool IsValid(this Encoding encoding, byte[] bytes, int index, int count)
        {
            try
            {
                var decoder = encoding.GetDecoder();
                decoder.Fallback = DecoderFallback.ExceptionFallback;
                decoder.GetCharCount(bytes, index, count);
                return true;
            }
            catch (DecoderFallbackException)
            {
                return false;
            }
        }
    }
}