CRNCharsetConverter.h

Go to the documentation of this file.

/* Copyright 2012-2014 CoReNum, INSA-Lyon
 * 
 * This file is part of libcrn.
 * 
 * libcrn is free software: you can redistribute it and/or modify
 * it under the terms of the GNU Lesser General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 * 
 * libcrn is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU Lesser General Public License for more details.
 * 
 * You should have received a copy of the GNU Lesser General Public License
 * along with libcrn.  If not, see <http://www.gnu.org/licenses/>.
 * 
 * file: CRNCharsetConverter.h
 * \author Yann LEYDIER
 */

#ifndef CRNCharsetConverter_HEADER
#define CRNCharsetConverter_HEADER

#include <iconv.h>
#include <CRNException.h>

namespace crn
{
    class StringUTF8;

    class CharsetConverter
    {
        public:
            enum class Status { OK, BUFFER, INVALID, INCOMPLETE };

            class Exception: public crn::Exception
            {
                public:
                    explicit Exception() noexcept;
                    explicit Exception(const crn::StringUTF8 &msg) noexcept;
                    explicit Exception(const char *msg) noexcept;
            };

            class ExceptionInvalidCharacter: public Exception
            {
                public:
                    explicit ExceptionInvalidCharacter() noexcept;
                    explicit ExceptionInvalidCharacter(const crn::StringUTF8 &msg) noexcept;
                    explicit ExceptionInvalidCharacter(const char *msg) noexcept;
            };

            class ExceptionIncompleteCode: public Exception
            {
                public:
                    explicit ExceptionIncompleteCode() throw();
                    explicit ExceptionIncompleteCode(const crn::StringUTF8 &msg) noexcept;
                    explicit ExceptionIncompleteCode(const char *msg) noexcept;
            };

            CharsetConverter(const std::string &to_code, bool translit = true, bool throw_exceptions = true);
            CharsetConverter(const CharsetConverter&) = delete;
            CharsetConverter(CharsetConverter&&) = delete;
            CharsetConverter& operator=(const CharsetConverter&) = delete;
            CharsetConverter& operator=(CharsetConverter&&) = delete;
            ~CharsetConverter();

            void Reset(const std::string &to_code, bool translit = true);
            std::string FromUTF8(const crn::StringUTF8 &str, Status *stat = nullptr) const;
            crn::StringUTF8 ToUTF8(const std::string &str, Status *stat = nullptr) const;

            const std::string& GetCharset() const { return current_code; }

        private:
            std::string fromUTF8(const crn::StringUTF8 &str, size_t buff, Status *stat) const;
            crn::StringUTF8 toUTF8(const std::string &str, size_t buff, Status *stat) const;

            mutable iconv_t toutf, fromutf; 
            bool silent; 
            std::string current_code; 
            bool throws; 
    };
}

#include <CRNUtils/CRNCharsetConverterPtr.h>
#endif