// This is the SIP interface definition for TQCString.
//
// 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>TQCString (TQt v2+)</Title>
<Para>
A Python string can be used whenever a <Literal>TQCString</Literal> can be used.
A <Literal>TQCString</Literal> can be converted to a Python string using the
Python <Literal>str()</Literal> function.
</Para>

<FuncSynopsis>
	<FuncDef>TQCString &amp;<Function>sprintf</Function></FuncDef>
	<ParamDef>const char *<Parameter>format</Parameter></ParamDef>
	<ParamDef>...</ParamDef>
</FuncSynopsis>
<Para>
Not implemented.
</Para>

<FuncSynopsis>
	<FuncDef>short <Function>toShort</Function></FuncDef>
	<ParamDef>bool *<Parameter>ok</Parameter> = 0</ParamDef>
</FuncSynopsis>
<Para>
This returns a tuple of the <Literal>short</Literal> result and the
<Literal>ok</Literal> value.
</Para>

<FuncSynopsis>
	<FuncDef>ushort <Function>toUShort</Function></FuncDef>
	<ParamDef>bool *<Parameter>ok</Parameter> = 0</ParamDef>
</FuncSynopsis>
<Para>
This returns a tuple of the <Literal>ushort</Literal> result and the
<Literal>ok</Literal> value.
</Para>

<FuncSynopsis>
	<FuncDef>int <Function>toInt</Function></FuncDef>
	<ParamDef>bool *<Parameter>ok</Parameter> = 0</ParamDef>
</FuncSynopsis>
<Para>
This returns a tuple of the <Literal>int</Literal> result and the
<Literal>ok</Literal> value.
</Para>

<FuncSynopsis>
	<FuncDef>uint <Function>toUInt</Function></FuncDef>
	<ParamDef>bool *<Parameter>ok</Parameter> = 0</ParamDef>
</FuncSynopsis>
<Para>
This returns a tuple of the <Literal>uint</Literal> result and the
<Literal>ok</Literal> value.
</Para>

<FuncSynopsis>
	<FuncDef>long <Function>toLong</Function></FuncDef>
	<ParamDef>bool *<Parameter>ok</Parameter> = 0</ParamDef>
</FuncSynopsis>
<Para>
This returns a tuple of the <Literal>long</Literal> result and the
<Literal>ok</Literal> value.
</Para>

<FuncSynopsis>
	<FuncDef>ulong <Function>toULong</Function></FuncDef>
	<ParamDef>bool *<Parameter>ok</Parameter> = 0</ParamDef>
</FuncSynopsis>
<Para>
This returns a tuple of the <Literal>ulong</Literal> result and the
<Literal>ok</Literal> value.
</Para>

<FuncSynopsis>
	<FuncDef>float <Function>toFloat</Function></FuncDef>
	<ParamDef>bool *<Parameter>ok</Parameter> = 0</ParamDef>
</FuncSynopsis>
<Para>
This returns a tuple of the <Literal>float</Literal> result and the
<Literal>ok</Literal> value.
</Para>

<FuncSynopsis>
	<FuncDef>double <Function>toDouble</Function></FuncDef>
	<ParamDef>bool *<Parameter>ok</Parameter> = 0</ParamDef>
</FuncSynopsis>
<Para>
This returns a tuple of the <Literal>double</Literal> result and the
<Literal>ok</Literal> value.
</Para>
</Sect2>
%End


class TQCString : TQByteArray
{
%TypeHeaderCode
#include <tqcstring.h>
%End

public:
	TQCString();
	TQCString(int);
	TQCString(const TQCString &);
	TQCString(const char *);
	TQCString(const char *,uint);

	bool isNull() const;
	bool isEmpty() const;
	uint length() const;
	bool resize(uint);
	bool truncate(uint);
	bool fill(char,int = -1);
	TQCString copy() const;
//	TQCString &sprintf(const char *,...);
//	int find(char,int = 0,bool = 1) const;
	int find(const char *,int = 0,bool = 1) const;
	int find(const TQRegExp &,int = 0) const;
//	int findRev(char,int = -1,bool = 1) const;
	int findRev(const char *,int = -1,bool = 1) const;
	int findRev(const TQRegExp &,int = -1) const;
//	int contains(char,bool = 1) const;
	int contains(const char *,bool = 1) const;
	int contains(const TQRegExp &) const;
	TQCString left(uint) const;
	TQCString right(uint) const;
	TQCString mid(uint,uint = 0xffffffff) const;
	TQCString leftJustify(uint,char = ' ',bool = 0) const;
	TQCString rightJustify(uint,char = ' ',bool = 0) const;
	TQCString lower() const;
	TQCString upper() const;
	TQCString stripWhiteSpace() const;
	TQCString simplifyWhiteSpace() const;
	TQCString &insert(uint,const char *);
//	TQCString &insert(uint,char);
	TQCString &append(const char *);
	TQCString &prepend(const char *);
	TQCString &remove(uint,uint);
	TQCString &replace(uint,uint,const char *);
	TQCString &replace(const TQRegExp &,const char *);
//	TQCString &replace(char,const char *);
	TQCString &replace(const char *,const char *);
//	TQCString &replace(char,char);

	short toShort(bool * = 0) const;
	ushort toUShort(bool * = 0) const;
	int toInt(bool * = 0) const;
	uint toUInt(bool * = 0) const;
	long toLong(bool * = 0) const;
	ulong toULong(bool * = 0) const;
	float toFloat(bool * = 0) const;
	double toDouble(bool * = 0) const;

	TQCString &setStr(const char *);
//	TQCString &setNum(short);
//	TQCString &setNum(ushort);
	TQCString &setNum(int /Constrained/);
//	TQCString &setNum(uint);
//	TQCString &setNum(long);
//	TQCString &setNum(ulong);
//	TQCString &setNum(float,char = 'g',int = 6);
	TQCString &setNum(double,char = 'g',int = 6);
	bool setExpand(uint,char);

	SIP_PYOBJECT __str__();
%MethodCode
		const char *s;
 
		Py_BEGIN_ALLOW_THREADS
		s = *sipCpp;
		Py_END_ALLOW_THREADS

		if (s == NULL)
			s = "";
 
		sipRes = PyBytes_FromString(s);
%End

%ConvertToTypeCode
	// Allow a Python string whenever a TQCString is expected.

	if (sipIsErr == NULL)
		return (PyBytes_Check(sipPy) ||
			sipCanConvertToInstance(sipPy,sipClass_TQCString,SIP_NO_CONVERTORS));

	if (PyBytes_Check(sipPy))
	{
		*sipCppPtr = new TQCString(PyBytes_AS_STRING(sipPy));

		return sipGetState(sipTransferObj);
	}

	*sipCppPtr = reinterpret_cast<TQCString *>(sipConvertToInstance(sipPy,sipClass_TQCString,sipTransferObj,SIP_NO_CONVERTORS,0,sipIsErr));

	return 0;
%End
};
