// This is the SIP interface definition for TQTextCodec, TQTextDecoder and
// TQTextEncoder.
//
// Copyright (c) 2007
// 	Riverbank Computing Limited <info@riverbankcomputing.co.uk>
// 
// This file is part of PyTQt.
// 
// This copy of PyTQt is free software; you can redistribute it and/or modify it
// under the terms of the GNU General Public License as published by the Free
// Software Foundation; either version 2, or (at your option) any later
// version.
// 
// PyTQt is supplied 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 along with
// PyTQt; see the file LICENSE.  If not, write to the Free Software Foundation,
// Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
 
 
%ExportedDoc
<Sect2><Title>TQTextCodec (TQt v2+)</Title>
<FuncSynopsis>
	<FuncDef>virtual TQCString <Function>fromUnicode</Function></FuncDef>
	<ParamDef>const TQString &amp;<Parameter>uc</Parameter></ParamDef>
	<ParamDef>int &amp;<Parameter>lenInOut</Parameter></ParamDef>
</FuncSynopsis>
<Para>
The returned value is a tuple of the <Literal>TQCString</Literal> result and the
updated <Literal>lenInOut</Literal>.
</Para>
</Sect2>
 
<Sect2><Title>TQTextDecoder (TQt v2+)</Title>
<Para>
<Literal>TQTextDecoder</Literal> is fully implemented.
</Para>
</Sect2>
 
<Sect2><Title>TQTextEncoder (TQt v2+)</Title>
<FuncSynopsis>
	<FuncDef>virtual TQCString <Function>fromUnicode</Function> = 0</FuncDef>
	<ParamDef>const TQString &amp;<Parameter>uc</Parameter></ParamDef>
	<ParamDef>int &amp;<Parameter>lenInOut</Parameter></ParamDef>
</FuncSynopsis>
<Para>
The returned value is a tuple of the <Literal>TQCString</Literal> result and the
updated <Literal>lenInOut</Literal>.
</Para>
</Sect2>
%End


class TQTextEncoder
{
%TypeHeaderCode
#include <tqtextcodec.h>
%End

public:
	virtual TQCString fromUnicode(const TQString &,int & /In,Out/) = 0;
};


class TQTextDecoder
{
%TypeHeaderCode
#include <tqtextcodec.h>
%End

public:
	virtual TQString toUnicode(const char *,int) = 0;
};


class TQTextCodec
{
%TypeHeaderCode
#include <tqtextcodec.h>
%End

public:
%If (TQt_CODECS)
	static TQTextCodec *loadCharmap(TQIODevice *);
	static TQTextCodec *loadCharmapFile(TQString);
%End
	static TQTextCodec *codecForMib(int);
	static TQTextCodec *codecForName(const char *,int = 0);
	static TQTextCodec *codecForContent(const char *,int);
	static TQTextCodec *codecForIndex(int);
	static TQTextCodec *codecForLocale();
	static void setCodecForLocale(TQTextCodec *);

	static TQTextCodec *codecForTr();
	static void setCodecForTr(TQTextCodec *);
	static TQTextCodec *codecForCStrings();
	static void setCodecForCStrings(TQTextCodec *);

	static void deleteAllCodecs();

	static const char *locale();

	virtual const char *name() const = 0;
	virtual const char *mimeName() const;
	virtual int mibEnum() const = 0;

	virtual TQTextDecoder *makeDecoder() const /Factory/;
	virtual TQTextEncoder *makeEncoder() const /Factory/;

	virtual TQString toUnicode(const char *,int) const;
	virtual TQCString fromUnicode(const TQString &,int & /In,Out/) const;
	TQCString fromUnicode(const TQString &) const;
	TQString toUnicode(const TQByteArray &,int) const;
	TQString toUnicode(const TQByteArray &) const;
	TQString toUnicode(const TQCString &,int) const;
	TQString toUnicode(const TQCString &) const;
	TQString toUnicode(const char *) const;
	virtual bool canEncode(TQChar) const;
	virtual bool canEncode(const TQString &) const;

	virtual int heuristicContentMatch(const char *,int) const = 0;
	virtual int heuristicNameMatch(const char *) const;

	virtual TQByteArray fromUnicode(const TQString &,int,int) const;
	virtual unsigned short characterFromUnicode(const TQString &,int) const;

protected:
	TQTextCodec();
};
