/*MT*
    
    MediaTomb - http://www.mediatomb.cc/
    
    string_converter.h - this file is part of MediaTomb.
    
    Copyright (C) 2005 Gena Batyan <bgeradz@mediatomb.cc>,
                       Sergey 'Jin' Bostandzhyan <jin@mediatomb.cc>
    
    Copyright (C) 2006-2007 Gena Batyan <bgeradz@mediatomb.cc>,
                            Sergey 'Jin' Bostandzhyan <jin@mediatomb.cc>,
                            Leonhard Wimmer <leo@mediatomb.cc>
    
    MediaTomb is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License version 2
    as published by the Free Software Foundation.
    
    MediaTomb 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 General Public License for more details.
    
    You should have received a copy of the GNU General Public License
    version 2 along with MediaTomb; if not, write to the Free Software
    Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.
    
    $Id: string_converter.h 1124 2007-02-17 21:49:15Z lww $
*/

/// \file string_converter.h

#ifndef __STRING_CONVERTER_H__
#define __STRING_CONVERTER_H__

#include "common.h"
#include <iconv.h>

class StringConverter : public zmm::Object
{
public:
    StringConverter(zmm::String from, zmm::String to);
    virtual ~StringConverter();
    /// \brief Converts uses the from and to values that were passed 
    /// to the constructor to convert the string str to a specific character 
    /// set.
    /// \param str String to be converted.
    /// \param validate if this parameter is true then an exception will be 
    /// thrown if illegal input is encountered. If false, illegal characters
    /// will be padded with '?' and the function will return the string.
    zmm::String convert(zmm::String str, bool validate=false);
    bool validate(zmm::String str);

    static zmm::Ref<StringConverter> i2f();
    static zmm::Ref<StringConverter> f2i();
    static zmm::Ref<StringConverter> m2i();
#ifdef HAVE_JS    
    static zmm::Ref<StringConverter> j2i();
#endif
protected:
    iconv_t cd;
    bool dirty;

    zmm::String _convert(zmm::String str, bool validate);
};

#endif // __STRING_CONVERTER_H__