Context Navigation

qstring-h.html

Last change on this file was 190, checked in by rudi, 14 years ago
reference documentation added
File size: 39.4 KB

Rev	Line
[190]	1	<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
	2	<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/include/qstring.h:1 -->
	3	<html>
	4	<head>
	5	<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
	6	<title>qstring.h Include File</title>
	7	<style type="text/css"><!--
	8	fn { margin-left: 1cm; text-indent: -1cm; }
	9	a:link { color: #004faf; text-decoration: none }
	10	a:visited { color: #672967; text-decoration: none }
	11	body { background: #ffffff; color: black; }
	12	--></style>
	13	</head>
	14	<body>
	15
	16	<table border="0" cellpadding="0" cellspacing="0" width="100%">
	17	<tr bgcolor="#E5E5E5">
	18	<td valign=center>
	19	<a href="index.html">
	20	<font color="#004faf">Home</font></a>
	21	\| <a href="classes.html">
	22	<font color="#004faf">All Classes</font></a>
	23	\| <a href="mainclasses.html">
	24	<font color="#004faf">Main Classes</font></a>
	25	\| <a href="annotated.html">
	26	<font color="#004faf">Annotated</font></a>
	27	\| <a href="groups.html">
	28	<font color="#004faf">Grouped Classes</font></a>
	29	\| <a href="functions.html">
	30	<font color="#004faf">Functions</font></a>
	31	</td>
	32	<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>qstring.h</h1>
	33
	34	<p>This is the verbatim text of the qstring.h include file. It is provided only for illustration; the copyright remains with Trolltech.
	35	<hr>
	36	<pre>
	37	/****************************************************************************
	38	** $Id: qstring-h.html 2051 2007-02-21 10:04:20Z chehrlic $
	39	**
	40	** Definition of the QString class, and related Unicode functions.
	41	**
	42	** Created : 920609
	43	**
	44	** Copyright (C) 1992-2007 Trolltech ASA. All rights reserved.
	45	**
	46	** This file is part of the tools module of the Qt GUI Toolkit.
	47	**
	48	** This file may be distributed under the terms of the Q Public License
	49	** as defined by Trolltech ASA of Norway and appearing in the file
	50	** LICENSE.QPL included in the packaging of this file.
	51	**
	52	** This file may be distributed and/or modified under the terms of the
	53	** GNU General Public License version 2 as published by the Free Software
	54	** Foundation and appearing in the file LICENSE.GPL included in the
	55	** packaging of this file.
	56	**
	57	** Licensees holding valid Qt Enterprise Edition or Qt Professional Edition
	58	** licenses may use this file in accordance with the Qt Commercial License
	59	** Agreement provided with the Software.
	60	**
	61	** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
	62	** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
	63	**
	64	** See http://www.trolltech.com/pricing.html or email sales@trolltech.com for
	65	** information about Qt Commercial License Agreements.
	66	** See http://www.trolltech.com/qpl/ for QPL licensing information.
	67	** See http://www.trolltech.com/gpl/ for GPL licensing information.
	68	**
	69	** Contact info@trolltech.com if any conditions of this licensing are
	70	** not clear to you.
	71	**
	72	**********************************************************************/
	73
	74	#ifndef QSTRING_H
	75	#define QSTRING_H
	76
	77	#ifndef QT_H
	78	#include "qcstring.h"
	79	#endif // QT_H
	80
	81	#ifndef QT_NO_CAST_ASCII
	82	#include <limits.h>
	83	#endif
	84
	85	#ifndef QT_NO_STL
	86	#if defined ( Q_CC_MSVC_NET ) && _MSC_VER < 1310 // Avoids nasty warning for xlocale, line 450
	87	# pragma warning ( push )
	88	# pragma warning ( disable : 4189 )
	89	# include <string>
	90	# pragma warning ( pop )
	91	#else
	92	# include <string>
	93	#endif
	94	#if defined(Q_WRONG_SB_CTYPE_MACROS) && defined(_SB_CTYPE_MACROS)
	95	#undef _SB_CTYPE_MACROS
	96	#endif
	97	#endif
	98
	99
	100	/*****************************************************************************
	101	QString class
	102	*****************************************************************************/
	103
	104	class QRegExp;
	105	class QString;
	106	class QCharRef;
	107	template <class T> class QDeepCopy;
	108
	109	class Q_EXPORT QChar {
	110	public:
	111	QChar();
	112	QChar( char c );
	113	QChar( uchar c );
	114	QChar( uchar c, uchar r );
	115	QChar( const QChar& c ); // ### remove in 4.0 to allow compiler optimization
	116	QChar( ushort rc );
	117	QChar( short rc );
	118	QChar( uint rc );
	119	QChar( int rc );
	120
	121	QT_STATIC_CONST QChar null; // 0000
	122	QT_STATIC_CONST QChar replacement; // FFFD
	123	QT_STATIC_CONST QChar byteOrderMark; // FEFF
	124	QT_STATIC_CONST QChar byteOrderSwapped; // FFFE
	125	QT_STATIC_CONST QChar nbsp; // 00A0
	126
	127	// Unicode information
	128
	129	enum Category
	130	{
	131	NoCategory,
	132
	133	Mark_NonSpacing, // Mn
	134	Mark_SpacingCombining, // Mc
	135	Mark_Enclosing, // Me
	136
	137	Number_DecimalDigit, // Nd
	138	Number_Letter, // Nl
	139	Number_Other, // No
	140
	141	Separator_Space, // Zs
	142	Separator_Line, // Zl
	143	Separator_Paragraph, // Zp
	144
	145	Other_Control, // Cc
	146	Other_Format, // Cf
	147	Other_Surrogate, // Cs
	148	Other_PrivateUse, // Co
	149	Other_NotAssigned, // Cn
	150
	151	Letter_Uppercase, // Lu
	152	Letter_Lowercase, // Ll
	153	Letter_Titlecase, // Lt
	154	Letter_Modifier, // Lm
	155	Letter_Other, // Lo
	156
	157	Punctuation_Connector, // Pc
	158	Punctuation_Dash, // Pd
	159	Punctuation_Dask = Punctuation_Dash, // oops
	160	Punctuation_Open, // Ps
	161	Punctuation_Close, // Pe
	162	Punctuation_InitialQuote, // Pi
	163	Punctuation_FinalQuote, // Pf
	164	Punctuation_Other, // Po
	165
	166	Symbol_Math, // Sm
	167	Symbol_Currency, // Sc
	168	Symbol_Modifier, // Sk
	169	Symbol_Other // So
	170	};
	171
	172	enum Direction
	173	{
	174	DirL, DirR, DirEN, DirES, DirET, DirAN, DirCS, DirB, DirS, DirWS, DirON,
	175	DirLRE, DirLRO, DirAL, DirRLE, DirRLO, DirPDF, DirNSM, DirBN
	176	};
	177
	178	enum Decomposition
	179	{
	180	Single, Canonical, Font, NoBreak, Initial, Medial,
	181	Final, Isolated, Circle, Super, Sub, Vertical,
	182	Wide, Narrow, Small, Square, Compat, Fraction
	183	};
	184
	185	enum Joining
	186	{
	187	OtherJoining, Dual, Right, Center
	188	};
	189
	190	enum CombiningClass
	191	{
	192	Combining_BelowLeftAttached = 200,
	193	Combining_BelowAttached = 202,
	194	Combining_BelowRightAttached = 204,
	195	Combining_LeftAttached = 208,
	196	Combining_RightAttached = 210,
	197	Combining_AboveLeftAttached = 212,
	198	Combining_AboveAttached = 214,
	199	Combining_AboveRightAttached = 216,
	200
	201	Combining_BelowLeft = 218,
	202	Combining_Below = 220,
	203	Combining_BelowRight = 222,
	204	Combining_Left = 224,
	205	Combining_Right = 226,
	206	Combining_AboveLeft = 228,
	207	Combining_Above = 230,
	208	Combining_AboveRight = 232,
	209
	210	Combining_DoubleBelow = 233,
	211	Combining_DoubleAbove = 234,
	212	Combining_IotaSubscript = 240
	213	};
	214
	215	// ****** WHEN ADDING FUNCTIONS, CONSIDER ADDING TO QCharRef TOO
	216
	217	int digitValue() const;
	218	QChar lower() const;
	219	QChar upper() const;
	220
	221	Category category() const;
	222	Direction direction() const;
	223	Joining joining() const;
	224	bool mirrored() const;
	225	QChar mirroredChar() const;
	226	const QString &decomposition() const; // ### return just QString in 4.0
	227	Decomposition decompositionTag() const;
	228	unsigned char combiningClass() const;
	229
	230	char latin1() const { return ucs > 0xff ? 0 : (char) ucs; }
	231	ushort unicode() const { return ucs; }
	232	#ifdef Q_NO_PACKED_REFERENCE
	233	ushort &unicode() { return *(&ucs); }
	234	#else
	235	ushort &unicode() { return ucs; }
	236	#endif
	237	#ifndef QT_NO_CAST_ASCII
	238	// like all ifdef'd code this is undocumented
	239	operator char() const { return latin1(); }
	240	#endif
	241
	242	bool isNull() const { return unicode()==0; }
	243	bool isPrint() const;
	244	bool isPunct() const;
	245	bool isSpace() const;
	246	bool isMark() const;
	247	bool isLetter() const;
	248	bool isNumber() const;
	249	bool isLetterOrNumber() const;
	250	bool isDigit() const;
	251	bool isSymbol() const;
	252
	253	uchar cell() const { return ((uchar) ucs & 0xff); }
	254	uchar row() const { return ((uchar) (ucs>>8)&0xff); }
	255	void setCell( uchar cell ) { ucs = (ucs & 0xff00) + cell; }
	256	void setRow( uchar row ) { ucs = (((ushort) row)<<8) + (ucs&0xff); }
	257
	258	static bool networkOrdered() {
	259	int wordSize;
	260	bool bigEndian = FALSE;
	261	qSysInfo( &wordSize, &bigEndian );
	262	return bigEndian;
	263	}
	264
	265	friend inline bool operator==( char ch, QChar c );
	266	friend inline bool operator==( QChar c, char ch );
	267	friend inline bool operator==( QChar c1, QChar c2 );
	268	friend inline bool operator!=( QChar c1, QChar c2 );
	269	friend inline bool operator!=( char ch, QChar c );
	270	friend inline bool operator!=( QChar c, char ch );
	271	friend inline bool operator<=( QChar c, char ch );
	272	friend inline bool operator<=( char ch, QChar c );
	273	friend inline bool operator<=( QChar c1, QChar c2 );
	274
	275	private:
	276	ushort ucs;
	277	#if defined(QT_QSTRING_UCS_4)
	278	ushort grp;
	279	#endif
	280	} Q_PACKED;
	281
	282	inline QChar::QChar() : ucs( 0 )
	283	#ifdef QT_QSTRING_UCS_4
	284	, grp( 0 )
	285	#endif
	286	{
	287	}
	288	inline QChar::QChar( char c ) : ucs( (uchar)c )
	289	#ifdef QT_QSTRING_UCS_4
	290	, grp( 0 )
	291	#endif
	292	{
	293	}
	294	inline QChar::QChar( uchar c ) : ucs( c )
	295	#ifdef QT_QSTRING_UCS_4
	296	, grp( 0 )
	297	#endif
	298	{
	299	}
	300	inline QChar::QChar( uchar c, uchar r ) : ucs( (r << 8) \| c )
	301	#ifdef QT_QSTRING_UCS_4
	302	, grp( 0 )
	303	#endif
	304	{
	305	}
	306	inline QChar::QChar( const QChar& c ) : ucs( c.ucs )
	307	#ifdef QT_QSTRING_UCS_4
	308	, grp( c.grp )
	309	#endif
	310	{
	311	}
	312
	313	inline QChar::QChar( ushort rc ) : ucs( rc )
	314	#ifdef QT_QSTRING_UCS_4
	315	, grp( 0 )
	316	#endif
	317	{
	318	}
	319	inline QChar::QChar( short rc ) : ucs( (ushort) rc )
	320	#ifdef QT_QSTRING_UCS_4
	321	, grp( 0 )
	322	#endif
	323	{
	324	}
	325	inline QChar::QChar( uint rc ) : ucs( (ushort ) (rc & 0xffff) )
	326	#ifdef QT_QSTRING_UCS_4
	327	, grp( (ushort) ((rc >> 16) & 0xffff) )
	328	#endif
	329	{
	330	}
	331	inline QChar::QChar( int rc ) : ucs( (ushort) (rc & 0xffff) )
	332	#ifdef QT_QSTRING_UCS_4
	333	, grp( (ushort) ((rc >> 16) & 0xffff) )
	334	#endif
	335	{
	336	}
	337
	338	inline bool operator==( char ch, QChar c )
	339	{
	340	return ((uchar) ch) == c.ucs;
	341	}
	342
	343	inline bool operator==( QChar c, char ch )
	344	{
	345	return ((uchar) ch) == c.ucs;
	346	}
	347
	348	inline bool operator==( QChar c1, QChar c2 )
	349	{
	350	return c1.ucs == c2.ucs;
	351	}
	352
	353	inline bool operator!=( QChar c1, QChar c2 )
	354	{
	355	return c1.ucs != c2.ucs;
	356	}
	357
	358	inline bool operator!=( char ch, QChar c )
	359	{
	360	return ((uchar)ch) != c.ucs;
	361	}
	362
	363	inline bool operator!=( QChar c, char ch )
	364	{
	365	return ((uchar) ch) != c.ucs;
	366	}
	367
	368	inline bool operator<=( QChar c, char ch )
	369	{
	370	return c.ucs <= ((uchar) ch);
	371	}
	372
	373	inline bool operator<=( char ch, QChar c )
	374	{
	375	return ((uchar) ch) <= c.ucs;
	376	}
	377
	378	inline bool operator<=( QChar c1, QChar c2 )
	379	{
	380	return c1.ucs <= c2.ucs;
	381	}
	382
	383	inline bool operator>=( QChar c, char ch ) { return ch <= c; }
	384	inline bool operator>=( char ch, QChar c ) { return c <= ch; }
	385	inline bool operator>=( QChar c1, QChar c2 ) { return c2 <= c1; }
	386	inline bool operator<( QChar c, char ch ) { return !(ch<=c); }
	387	inline bool operator<( char ch, QChar c ) { return !(c<=ch); }
	388	inline bool operator<( QChar c1, QChar c2 ) { return !(c2<=c1); }
	389	inline bool operator>( QChar c, char ch ) { return !(ch>=c); }
	390	inline bool operator>( char ch, QChar c ) { return !(c>=ch); }
	391	inline bool operator>( QChar c1, QChar c2 ) { return !(c2>=c1); }
	392
	393	// internal
	394	struct Q_EXPORT QStringData : public QShared {
	395	QStringData() :
	396	QShared(), unicode(0), ascii(0), len(0), issimpletext(TRUE), maxl(0), islatin1(FALSE) { ref(); }
	397	QStringData(QChar *u, uint l, uint m) :
	398	QShared(), unicode(u), ascii(0), len(l), issimpletext(FALSE), maxl(m), islatin1(FALSE) { }
	399	~QStringData() { if ( unicode ) delete[] ((char*)unicode);
	400	if ( ascii ) delete[] ascii; }
	401
	402	void deleteSelf();
	403	QChar *unicode;
	404	char *ascii;
	405	void setDirty() {
	406	if ( ascii ) {
	407	delete [] ascii;
	408	ascii = 0;
	409	}
	410	issimpletext = FALSE;
	411	}
	412	#ifdef Q_OS_MAC9
	413	uint len;
	414	#else
	415	uint len : 30;
	416	#endif
	417	uint issimpletext : 1;
	418	#ifdef Q_OS_MAC9
	419	uint maxl;
	420	#else
	421	uint maxl : 30;
	422	#endif
	423	uint islatin1 : 1;
	424
	425	private:
	426	#if defined(Q_DISABLE_COPY)
	427	QStringData( const QStringData& );
	428	QStringData& operator=( const QStringData& );
	429	#endif
	430	};
	431
	432
	433	class Q_EXPORT QString
	434	{
	435	public:
	436	QString(); // make null string
	437	QString( QChar ); // one-char string
	438	QString( const QString & ); // impl-shared copy
	439	QString( const QByteArray& ); // deep copy
	440	QString( const QChar* unicode, uint length ); // deep copy
	441	#ifndef QT_NO_CAST_ASCII
	442	QString( const char *str ); // deep copy
	443	#endif
	444	#ifndef QT_NO_STL
	445	QString( const std::string& ); // deep copy
	446	#endif
	447	~QString();
	448
	449	QString &operator=( const QString & ); // impl-shared copy
	450	QString &operator=( const char * ); // deep copy
	451	#ifndef QT_NO_STL
	452	QString &operator=( const std::string& ); // deep copy
	453	#endif
	454	QString &operator=( const QCString& ); // deep copy
	455	QString &operator=( QChar c );
	456	QString &operator=( char c );
	457
	458	QT_STATIC_CONST QString null;
	459
	460	bool isNull() const;
	461	bool isEmpty() const;
	462	uint length() const;
	463	void truncate( uint pos );
	464
	465	QString & fill( QChar c, int len = -1 );
	466
	467	QString copy() const;
	468
	469	QString arg( long a, int fieldWidth = 0, int base = 10 ) const;
	470	QString arg( ulong a, int fieldWidth = 0, int base = 10 ) const;
	471	QString arg( Q_LLONG a, int fieldwidth=0, int base=10 ) const;
	472	QString arg( Q_ULLONG a, int fieldwidth=0, int base=10 ) const;
	473	QString arg( int a, int fieldWidth = 0, int base = 10 ) const;
	474	QString arg( uint a, int fieldWidth = 0, int base = 10 ) const;
	475	QString arg( short a, int fieldWidth = 0, int base = 10 ) const;
	476	QString arg( ushort a, int fieldWidth = 0, int base = 10 ) const;
	477	QString arg( double a, int fieldWidth = 0, char fmt = 'g',
	478	int prec = -1 ) const;
	479	QString arg( char a, int fieldWidth = 0 ) const;
	480	QString arg( QChar a, int fieldWidth = 0 ) const;
	481	QString arg( const QString& a, int fieldWidth = 0 ) const;
	482	QString arg( const QString& a1, const QString& a2 ) const;
	483	QString arg( const QString& a1, const QString& a2,
	484	const QString& a3 ) const;
	485	QString arg( const QString& a1, const QString& a2, const QString& a3,
	486	const QString& a4 ) const;
	487
	488	#ifndef QT_NO_SPRINTF
	489	QString &sprintf( const char* format, ... )
	490	#if defined(Q_CC_GNU) && !defined(__INSURE__)
	491	__attribute__ ((format (printf, 2, 3)))
	492	#endif
	493	;
	494	#endif
	495
	496	int find( QChar c, int index=0, bool cs=TRUE ) const;
	497	int find( char c, int index=0, bool cs=TRUE ) const;
	498	int find( const QString &str, int index=0, bool cs=TRUE ) const;
	499	#ifndef QT_NO_REGEXP
	500	int find( const QRegExp &, int index=0 ) const;
	501	#endif
	502	#ifndef QT_NO_CAST_ASCII
	503	int find( const char* str, int index=0 ) const;
	504	#endif
	505	int findRev( QChar c, int index=-1, bool cs=TRUE) const;
	506	int findRev( char c, int index=-1, bool cs=TRUE) const;
	507	int findRev( const QString &str, int index=-1, bool cs=TRUE) const;
	508	#ifndef QT_NO_REGEXP
	509	int findRev( const QRegExp &, int index=-1 ) const;
	510	#endif
	511	#ifndef QT_NO_CAST_ASCII
	512	int findRev( const char* str, int index=-1 ) const;
	513	#endif
	514	int contains( QChar c, bool cs=TRUE ) const;
	515	int contains( char c, bool cs=TRUE ) const
	516	{ return contains(QChar(c), cs); }
	517	#ifndef QT_NO_CAST_ASCII
	518	int contains( const char* str, bool cs=TRUE ) const;
	519	#endif
	520	int contains( const QString &str, bool cs=TRUE ) const;
	521	#ifndef QT_NO_REGEXP
	522	int contains( const QRegExp & ) const;
	523	#endif
	524
	525	enum SectionFlags {
	526	SectionDefault = 0x00,
	527	SectionSkipEmpty = 0x01,
	528	SectionIncludeLeadingSep = 0x02,
	529	SectionIncludeTrailingSep = 0x04,
	530	SectionCaseInsensitiveSeps = 0x08
	531	};
	532	QString section( QChar sep, int start, int end = 0xffffffff, int flags = SectionDefault ) const;
	533	QString section( char sep, int start, int end = 0xffffffff, int flags = SectionDefault ) const;
	534	#ifndef QT_NO_CAST_ASCII
	535	QString section( const char *in_sep, int start, int end = 0xffffffff, int flags = SectionDefault ) const;
	536	#endif
	537	QString section( const QString &in_sep, int start, int end = 0xffffffff, int flags = SectionDefault ) const;
	538	#ifndef QT_NO_REGEXP
	539	QString section( const QRegExp &reg, int start, int end = 0xffffffff, int flags = SectionDefault ) const;
	540	#endif
	541
	542	QString left( uint len ) const;
	543	QString right( uint len ) const;
	544	QString mid( uint index, uint len=0xffffffff) const;
	545
	546	QString leftJustify( uint width, QChar fill=' ', bool trunc=FALSE)const;
	547	QString rightJustify( uint width, QChar fill=' ',bool trunc=FALSE)const;
	548
	549	QString lower() const;
	550	QString upper() const;
	551
	552	QString stripWhiteSpace() const;
	553	QString simplifyWhiteSpace() const;
	554
	555	QString &insert( uint index, const QString & );
	556	#ifndef QT_NO_CAST_ASCII
	557	QString &insert( uint index, const QByteArray & );
	558	QString &insert( uint index, const char * );
	559	#endif
	560	QString &insert( uint index, const QChar*, uint len );
	561	QString &insert( uint index, QChar );
	562	QString &insert( uint index, char c ) { return insert(index,QChar(c)); }
	563	QString &append( char );
	564	QString &append( QChar );
	565	QString &append( const QString & );
	566	#ifndef QT_NO_CAST_ASCII
	567	QString &append( const QByteArray & );
	568	QString &append( const char * );
	569	#endif
	570	#if !defined(QT_NO_STL) && !defined(QT_NO_CAST_ASCII)
	571	QString &append( const std::string& );
	572	#endif
	573	QString &prepend( char );
	574	QString &prepend( QChar );
	575	QString &prepend( const QString & );
	576	#ifndef QT_NO_CAST_ASCII
	577	QString &prepend( const QByteArray & );
	578	QString &prepend( const char * );
	579	#endif
	580	#if !defined(QT_NO_STL) && !defined(QT_NO_CAST_ASCII)
	581	QString &prepend( const std::string& );
	582	#endif
	583	QString &remove( uint index, uint len );
	584	#if defined(Q_QDOC)
	585	QString &remove( const QString & str, bool cs = TRUE );
	586	#else
	587	// ### Qt 4.0: merge these two into one, and remove Q_QDOC hack
	588	QString &remove( const QString & );
	589	QString &remove( const QString &, bool cs );
	590	#endif
	591	QString &remove( QChar c );
	592	QString &remove( char c )
	593	{ return remove( QChar(c) ); }
	594	#ifndef QT_NO_CAST_ASCII
	595	QString &remove( const char * );
	596	#endif
	597	#ifndef QT_NO_REGEXP
	598	QString &remove( const QRegExp & );
	599	#endif
	600	QString &replace( uint index, uint len, const QString & );
	601	QString &replace( uint index, uint len, const QChar*, uint clen );
	602	QString &replace( uint index, uint len, QChar );
	603	QString &replace( uint index, uint len, char c )
	604	{ return replace( index, len, QChar(c) ); }
	605	#if defined(Q_QDOC)
	606	QString &replace( QChar c, const QString & after, bool cs = TRUE );
	607	QString &replace( char c, const QString & after, bool cs = TRUE );
	608	QString &replace( const QString & before, const QString & after,
	609	bool cs = TRUE );
	610	#else
	611	// ### Qt 4.0: merge these two into one, and remove Q_QDOC hack
	612	QString &replace( QChar c, const QString & );
	613	QString &replace( QChar c, const QString &, bool );
	614
	615	// ### Qt 4.0: merge these two into one, and remove Q_QDOC hack
	616	QString &replace( char c, const QString & after )
	617	{ return replace( QChar(c), after, TRUE ); }
	618	QString &replace( char c, const QString & after, bool cs )
	619	{ return replace( QChar(c), after, cs ); }
	620
	621	// ### Qt 4.0: merge these two into one, and remove Q_QDOC hack
	622	QString &replace( const QString &, const QString & );
	623	QString &replace( const QString &, const QString &, bool );
	624	#endif
	625	#ifndef QT_NO_REGEXP_CAPTURE
	626	QString &replace( const QRegExp &, const QString & );
	627	#endif
	628	QString &replace( QChar, QChar );
	629
	630	short toShort( bool *ok=0, int base=10 ) const;
	631	ushort toUShort( bool *ok=0, int base=10 ) const;
	632	int toInt( bool *ok=0, int base=10 ) const;
	633	uint toUInt( bool *ok=0, int base=10 ) const;
	634	long toLong( bool *ok=0, int base=10 ) const;
	635	ulong toULong( bool *ok=0, int base=10 ) const;
	636	Q_LLONG toLongLong( bool *ok=0, int base=10 ) const;
	637	Q_ULLONG toULongLong( bool *ok=0, int base=10 ) const;
	638	float toFloat( bool *ok=0 ) const;
	639	double toDouble( bool *ok=0 ) const;
	640
	641	QString &setNum( short, int base=10 );
	642	QString &setNum( ushort, int base=10 );
	643	QString &setNum( int, int base=10 );
	644	QString &setNum( uint, int base=10 );
	645	QString &setNum( long, int base=10 );
	646	QString &setNum( ulong, int base=10 );
	647	QString &setNum( Q_LLONG, int base=10 );
	648	QString &setNum( Q_ULLONG, int base=10 );
	649	QString &setNum( float, char f='g', int prec=6 );
	650	QString &setNum( double, char f='g', int prec=6 );
	651
	652	static QString number( long, int base=10 );
	653	static QString number( ulong, int base=10);
	654	static QString number( Q_LLONG, int base=10 );
	655	static QString number( Q_ULLONG, int base=10);
	656	static QString number( int, int base=10 );
	657	static QString number( uint, int base=10);
	658	static QString number( double, char f='g', int prec=6 );
	659
	660	void setExpand( uint index, QChar c );
	661
	662	QString &operator+=( const QString &str );
	663	#ifndef QT_NO_CAST_ASCII
	664	QString &operator+=( const QByteArray &str );
	665	QString &operator+=( const char *str );
	666	#endif
	667	#if !defined(QT_NO_STL) && !defined(QT_NO_CAST_ASCII)
	668	QString &operator+=( const std::string& );
	669	#endif
	670	QString &operator+=( QChar c );
	671	QString &operator+=( char c );
	672
	673	QChar at( uint i ) const
	674	{ return i < d->len ? d->unicode[i] : QChar::null; }
	675	QChar operator[]( int i ) const { return at((uint)i); }
	676	QCharRef at( uint i );
	677	QCharRef operator[]( int i );
	678
	679	QChar constref(uint i) const
	680	{ return at(i); }
	681	QChar& ref(uint i)
	682	{ // Optimized for easy-inlining by simple compilers.
	683	if ( d->count != 1 \|\| i >= d->len )
	684	subat( i );
	685	d->setDirty();
	686	return d->unicode[i];
	687	}
	688
	689	const QChar* unicode() const { return d->unicode; }
	690	const char* ascii() const;
	691	static QString fromAscii(const char*, int len=-1);
	692	const char* latin1() const;
	693	static QString fromLatin1(const char*, int len=-1);
	694	QCString utf8() const;
	695	static QString fromUtf8(const char*, int len=-1);
	696	QCString local8Bit() const;
	697	static QString fromLocal8Bit(const char*, int len=-1);
	698	bool operator!() const;
	699	#ifndef QT_NO_ASCII_CAST
	700	operator const char *() const { return ascii(); }
	701	#endif
	702	#ifndef QT_NO_STL
	703	operator std::string() const { return ascii() ? ascii() : ""; }
	704	#endif
	705
	706	static QString fromUcs2( const unsigned short *ucs2 );
	707	const unsigned short *ucs2() const;
	708
	709	QString &setUnicode( const QChar* unicode, uint len );
	710	QString &setUnicodeCodes( const ushort* unicode_as_ushorts, uint len );
	711	QString &setAscii( const char*, int len=-1 );
	712	QString &setLatin1( const char*, int len=-1 );
	713
	714	int compare( const QString& s ) const;
	715	static int compare( const QString& s1, const QString& s2 )
	716	{ return s1.compare( s2 ); }
	717
	718	int localeAwareCompare( const QString& s ) const;
	719	static int localeAwareCompare( const QString& s1, const QString& s2 )
	720	{ return s1.localeAwareCompare( s2 ); }
	721
	722	#ifndef QT_NO_DATASTREAM
	723	friend Q_EXPORT QDataStream &operator>>( QDataStream &, QString & );
	724	#endif
	725
	726	void compose();
	727
	728	#ifndef QT_NO_COMPAT
	729	const char* data() const { return ascii(); }
	730	#endif
	731
	732	#if defined(Q_QDOC)
	733	bool startsWith( const QString& str, bool cs = TRUE ) const;
	734	bool endsWith( const QString& str, bool cs = TRUE ) const;
	735	#else
	736	// ### Qt 4.0: merge these two into one, and remove Q_QDOC hack
	737	bool startsWith( const QString& str ) const;
	738	bool startsWith( const QString& str, bool cs ) const;
	739
	740	// ### Qt 4.0: merge these two into one, and remove Q_QDOC hack
	741	bool endsWith( const QString& str ) const;
	742	bool endsWith( const QString& str, bool cs ) const;
	743	#endif
	744
	745	void setLength( uint newLength );
	746
	747	uint capacity() const;
	748	void reserve( uint minCapacity );
	749	void squeeze();
	750
	751	bool simpleText() const { if ( !d->issimpletext ) checkSimpleText(); return (bool)d->issimpletext; }
	752	bool isRightToLeft() const;
	753
	754
	755	private:
	756	QString( int size, bool /* dummy */ ); // allocate size incl. \0
	757
	758	void deref();
	759	void real_detach();
	760	void subat( uint );
	761	QString multiArg( int numArgs, const QString& a1, const QString& a2,
	762	const QString& a3 = QString::null,
	763	const QString& a4 = QString::null ) const;
	764
	765	void checkSimpleText() const;
	766	void grow( uint newLength );
	767	#ifndef QT_NO_CAST_ASCII
	768	QString &insertHelper( uint index, const char *s, uint len=UINT_MAX );
	769	QString &operatorPlusEqHelper( const char *s, uint len2=UINT_MAX );
	770	#endif
	771
	772	static QChar* latin1ToUnicode( const char, uint len, uint maxlen=(uint)-1 );
	773	static QChar* latin1ToUnicode( const QByteArray&, uint * len );
	774	static char* unicodeToLatin1( const QChar*, uint len );
	775
	776	QStringData *d;
	777	static QStringData* shared_null;
	778	static QStringData* makeSharedNull();
	779
	780	friend class QConstString;
	781	friend class QTextStream;
	782	QString( QStringData* dd, bool /* dummy */ ) : d(dd) { }
	783
	784	// needed for QDeepCopy
	785	void detach();
	786	friend class QDeepCopy<QString>;
	787	};
	788
	789	class Q_EXPORT QCharRef {
	790	friend class QString;
	791	QString& s;
	792	uint p;
	793	QCharRef(QString* str, uint pos) : s(*str), p(pos) { }
	794
	795	public:
	796	// most QChar operations repeated here
	797
	798	// all this is not documented: We just say "like QChar" and let it be.
	799	#ifndef Q_QDOC
	800	ushort unicode() const { return s.constref(p).unicode(); }
	801	char latin1() const { return s.constref(p).latin1(); }
	802
	803	// An operator= for each QChar cast constructors
	804	QCharRef operator=(char c ) { s.ref(p)=c; return *this; }
	805	QCharRef operator=(uchar c ) { s.ref(p)=c; return *this; }
	806	QCharRef operator=(QChar c ) { s.ref(p)=c; return *this; }
	807	QCharRef operator=(const QCharRef& c ) { s.ref(p)=c.unicode(); return *this; }
	808	QCharRef operator=(ushort rc ) { s.ref(p)=rc; return *this; }
	809	QCharRef operator=(short rc ) { s.ref(p)=rc; return *this; }
	810	QCharRef operator=(uint rc ) { s.ref(p)=rc; return *this; }
	811	QCharRef operator=(int rc ) { s.ref(p)=rc; return *this; }
	812
	813	operator QChar () const { return s.constref(p); }
	814
	815	// each function...
	816	bool isNull() const { return unicode()==0; }
	817	bool isPrint() const { return s.constref(p).isPrint(); }
	818	bool isPunct() const { return s.constref(p).isPunct(); }
	819	bool isSpace() const { return s.constref(p).isSpace(); }
	820	bool isMark() const { return s.constref(p).isMark(); }
	821	bool isLetter() const { return s.constref(p).isLetter(); }
	822	bool isNumber() const { return s.constref(p).isNumber(); }
	823	bool isLetterOrNumber() { return s.constref(p).isLetterOrNumber(); }
	824	bool isDigit() const { return s.constref(p).isDigit(); }
	825
	826	int digitValue() const { return s.constref(p).digitValue(); }
	827	QChar lower() const { return s.constref(p).lower(); }
	828	QChar upper() const { return s.constref(p).upper(); }
	829
	830	QChar::Category category() const { return s.constref(p).category(); }
	831	QChar::Direction direction() const { return s.constref(p).direction(); }
	832	QChar::Joining joining() const { return s.constref(p).joining(); }
	833	bool mirrored() const { return s.constref(p).mirrored(); }
	834	QChar mirroredChar() const { return s.constref(p).mirroredChar(); }
	835	const QString &decomposition() const { return s.constref(p).decomposition(); }
	836	QChar::Decomposition decompositionTag() const { return s.constref(p).decompositionTag(); }
	837	unsigned char combiningClass() const { return s.constref(p).combiningClass(); }
	838
	839	// Not the non-const ones of these.
	840	uchar cell() const { return s.constref(p).cell(); }
	841	uchar row() const { return s.constref(p).row(); }
	842	#endif
	843	};
	844
	845	inline QCharRef QString::at( uint i ) { return QCharRef(this,i); }
	846	inline QCharRef QString::operator[]( int i ) { return at((uint)i); }
	847
	848
	849	class Q_EXPORT QConstString : private QString {
	850	public:
	851	QConstString( const QChar* unicode, uint length );
	852	~QConstString();
	853	const QString& string() const { return *this; }
	854	};
	855
	856
	857	/*****************************************************************************
	858	QString stream functions
	859	*****************************************************************************/
	860	#ifndef QT_NO_DATASTREAM
	861	Q_EXPORT QDataStream &operator<<( QDataStream &, const QString & );
	862	Q_EXPORT QDataStream &operator>>( QDataStream &, QString & );
	863	#endif
	864
	865	/*****************************************************************************
	866	QString inline functions
	867	*****************************************************************************/
	868
	869	// These two move code into makeSharedNull() and deletesData()
	870	// to improve cache-coherence (and reduce code bloat), while
	871	// keeping the common cases fast.
	872	//
	873	// No safe way to pre-init shared_null on ALL compilers/linkers.
	874	inline QString::QString() :
	875	d(shared_null ? shared_null : makeSharedNull())
	876	{
	877	d->ref();
	878	}
	879	//
	880	inline QString::~QString()
	881	{
	882	if ( d->deref() ) {
	883	if ( d != shared_null )
	884	d->deleteSelf();
	885	}
	886	}
	887
	888	// needed for QDeepCopy
	889	inline void QString::detach()
	890	{ real_detach(); }
	891
	892	inline QString QString::section( QChar sep, int start, int end, int flags ) const
	893	{ return section(QString(sep), start, end, flags); }
	894
	895	inline QString QString::section( char sep, int start, int end, int flags ) const
	896	{ return section(QChar(sep), start, end, flags); }
	897
	898	#ifndef QT_NO_CAST_ASCII
	899	inline QString QString::section( const char *in_sep, int start, int end, int flags ) const
	900	{ return section(QString(in_sep), start, end, flags); }
	901	#endif
	902
	903	inline QString &QString::operator=( QChar c )
	904	{ this = QString(c); return this; }
	905
	906	inline QString &QString::operator=( char c )
	907	{ this = QString(QChar(c)); return this; }
	908
	909	inline bool QString::isNull() const
	910	{ return unicode() == 0; }
	911
	912	inline bool QString::operator!() const
	913	{ return isNull(); }
	914
	915	inline uint QString::length() const
	916	{ return d->len; }
	917
	918	inline uint QString::capacity() const
	919	{ return d->maxl; }
	920
	921	inline bool QString::isEmpty() const
	922	{ return length() == 0; }
	923
	924	inline QString QString::copy() const
	925	{ return QString( *this ); }
	926
	927	#ifndef QT_NO_CAST_ASCII
	928	inline QString &QString::insert( uint index, const char *s )
	929	{ return insertHelper( index, s ); }
	930
	931	inline QString &QString::insert( uint index, const QByteArray &s )
	932	{
	933	int pos = s.find( 0 );
	934	return insertHelper( index, s, pos==-1 ? s.size() : pos );
	935	}
	936	#endif
	937
	938	inline QString &QString::prepend( const QString & s )
	939	{ return insert(0,s); }
	940
	941	inline QString &QString::prepend( QChar c )
	942	{ return insert(0,c); }
	943
	944	inline QString &QString::prepend( char c )
	945	{ return insert(0,c); }
	946
	947	#ifndef QT_NO_CAST_ASCII
	948	inline QString &QString::prepend( const QByteArray & s )
	949	{ return insert(0,s); }
	950	#endif
	951
	952	#ifndef QT_NO_CAST_ASCII
	953	inline QString &QString::operator+=( const QByteArray &s )
	954	{
	955	int pos = s.find( 0 );
	956	return operatorPlusEqHelper( s, pos==-1 ? s.size() : pos );
	957	}
	958	#endif
	959
	960	inline QString &QString::append( const QString & s )
	961	{ return operator+=(s); }
	962
	963	#ifndef QT_NO_CAST_ASCII
	964	inline QString &QString::append( const QByteArray &s )
	965	{ return operator+=(s); }
	966
	967	inline QString &QString::append( const char * s )
	968	{ return operator+=(s); }
	969	#endif
	970
	971	inline QString &QString::append( QChar c )
	972	{ return operator+=(c); }
	973
	974	inline QString &QString::append( char c )
	975	{ return operator+=(c); }
	976
	977	#ifndef QT_NO_STL
	978	inline QString &QString::operator=( const std::string& str )
	979	{ return operator=(str.c_str()); }
	980	#ifndef QT_NO_CAST_ASCII
	981	inline QString &QString::operator+=( const std::string& s )
	982	{ return operator+=(s.c_str()); }
	983	inline QString &QString::append( const std::string& s )
	984	{ return operator+=(s); }
	985	inline QString &QString::prepend( const std::string& s )
	986	{ return insert(0, s); }
	987	#endif
	988	#endif
	989
	990	inline QString &QString::setNum( short n, int base )
	991	{ return setNum((Q_LLONG)n, base); }
	992
	993	inline QString &QString::setNum( ushort n, int base )
	994	{ return setNum((Q_ULLONG)n, base); }
	995
	996	inline QString &QString::setNum( int n, int base )
	997	{ return setNum((Q_LLONG)n, base); }
	998
	999	inline QString &QString::setNum( uint n, int base )
	1000	{ return setNum((Q_ULLONG)n, base); }
	1001
	1002	inline QString &QString::setNum( float n, char f, int prec )
	1003	{ return setNum((double)n,f,prec); }
	1004
	1005	inline QString QString::arg( int a, int fieldWidth, int base ) const
	1006	{ return arg( (Q_LLONG)a, fieldWidth, base ); }
	1007
	1008	inline QString QString::arg( uint a, int fieldWidth, int base ) const
	1009	{ return arg( (Q_ULLONG)a, fieldWidth, base ); }
	1010
	1011	inline QString QString::arg( short a, int fieldWidth, int base ) const
	1012	{ return arg( (Q_LLONG)a, fieldWidth, base ); }
	1013
	1014	inline QString QString::arg( ushort a, int fieldWidth, int base ) const
	1015	{ return arg( (Q_ULLONG)a, fieldWidth, base ); }
	1016
	1017	inline QString QString::arg( const QString& a1, const QString& a2 ) const {
	1018	return multiArg( 2, a1, a2 );
	1019	}
	1020
	1021	inline QString QString::arg( const QString& a1, const QString& a2,
	1022	const QString& a3 ) const {
	1023	return multiArg( 3, a1, a2, a3 );
	1024	}
	1025
	1026	inline QString QString::arg( const QString& a1, const QString& a2,
	1027	const QString& a3, const QString& a4 ) const {
	1028	return multiArg( 4, a1, a2, a3, a4 );
	1029	}
	1030
	1031	inline int QString::find( char c, int index, bool cs ) const
	1032	{ return find(QChar(c), index, cs); }
	1033
	1034	inline int QString::findRev( char c, int index, bool cs ) const
	1035	{ return findRev( QChar(c), index, cs ); }
	1036
	1037	#ifndef QT_NO_CAST_ASCII
	1038	inline int QString::find( const char* str, int index ) const
	1039	{ return find(QString::fromAscii(str), index); }
	1040
	1041	inline int QString::findRev( const char* str, int index ) const
	1042	{ return findRev(QString::fromAscii(str), index); }
	1043	#endif
	1044
	1045
	1046	/*****************************************************************************
	1047	QString non-member operators
	1048	*****************************************************************************/
	1049
	1050	Q_EXPORT bool operator!=( const QString &s1, const QString &s2 );
	1051	Q_EXPORT bool operator<( const QString &s1, const QString &s2 );
	1052	Q_EXPORT bool operator<=( const QString &s1, const QString &s2 );
	1053	Q_EXPORT bool operator==( const QString &s1, const QString &s2 );
	1054	Q_EXPORT bool operator>( const QString &s1, const QString &s2 );
	1055	Q_EXPORT bool operator>=( const QString &s1, const QString &s2 );
	1056	#ifndef QT_NO_CAST_ASCII
	1057	Q_EXPORT bool operator!=( const QString &s1, const char *s2 );
	1058	Q_EXPORT bool operator<( const QString &s1, const char *s2 );
	1059	Q_EXPORT bool operator<=( const QString &s1, const char *s2 );
	1060	Q_EXPORT bool operator==( const QString &s1, const char *s2 );
	1061	Q_EXPORT bool operator>( const QString &s1, const char *s2 );
	1062	Q_EXPORT bool operator>=( const QString &s1, const char *s2 );
	1063	Q_EXPORT bool operator!=( const char *s1, const QString &s2 );
	1064	Q_EXPORT bool operator<( const char *s1, const QString &s2 );
	1065	Q_EXPORT bool operator<=( const char *s1, const QString &s2 );
	1066	Q_EXPORT bool operator==( const char *s1, const QString &s2 );
	1067	//Q_EXPORT bool operator>( const char *s1, const QString &s2 ); // MSVC++
	1068	Q_EXPORT bool operator>=( const char *s1, const QString &s2 );
	1069	#endif
	1070
	1071	Q_EXPORT inline const QString operator+( const QString &s1, const QString &s2 )
	1072	{
	1073	QString tmp( s1 );
	1074	tmp += s2;
	1075	return tmp;
	1076	}
	1077
	1078	#ifndef QT_NO_CAST_ASCII
	1079	Q_EXPORT inline const QString operator+( const QString &s1, const char *s2 )
	1080	{
	1081	QString tmp( s1 );
	1082	tmp += QString::fromAscii(s2);
	1083	return tmp;
	1084	}
	1085
	1086	Q_EXPORT inline const QString operator+( const char *s1, const QString &s2 )
	1087	{
	1088	QString tmp = QString::fromAscii( s1 );
	1089	tmp += s2;
	1090	return tmp;
	1091	}
	1092	#endif
	1093
	1094	Q_EXPORT inline const QString operator+( const QString &s1, QChar c2 )
	1095	{
	1096	QString tmp( s1 );
	1097	tmp += c2;
	1098	return tmp;
	1099	}
	1100
	1101	Q_EXPORT inline const QString operator+( const QString &s1, char c2 )
	1102	{
	1103	QString tmp( s1 );
	1104	tmp += c2;
	1105	return tmp;
	1106	}
	1107
	1108	Q_EXPORT inline const QString operator+( QChar c1, const QString &s2 )
	1109	{
	1110	QString tmp;
	1111	tmp += c1;
	1112	tmp += s2;
	1113	return tmp;
	1114	}
	1115
	1116	Q_EXPORT inline const QString operator+( char c1, const QString &s2 )
	1117	{
	1118	QString tmp;
	1119	tmp += c1;
	1120	tmp += s2;
	1121	return tmp;
	1122	}
	1123
	1124	#ifndef QT_NO_STL
	1125	Q_EXPORT inline const QString operator+(const QString& s1, const std::string& s2)
	1126	{
	1127	return s1 + QString(s2);
	1128	}
	1129
	1130	Q_EXPORT inline const QString operator+(const std::string& s1, const QString& s2)
	1131	{
	1132	QString tmp(s2);
	1133	return QString(tmp.prepend(s1));
	1134	}
	1135	#endif
	1136
	1137
	1138	#if defined(Q_OS_WIN32)
	1139	extern Q_EXPORT QString qt_winQString(void*);
	1140	extern Q_EXPORT const void* qt_winTchar(const QString& str, bool addnul);
	1141	extern Q_EXPORT void* qt_winTchar_new(const QString& str);
	1142	extern Q_EXPORT QCString qt_winQString2MB( const QString& s, int len=-1 );
	1143	extern Q_EXPORT QString qt_winMB2QString( const char* mb, int len=-1 );
	1144	#endif
	1145
	1146	#define Q_DEFINED_QSTRING
	1147	#include "qwinexport.h"
	1148	#endif // QSTRING_H
	1149	</pre>
	1150	<!-- eof -->
	1151	<p><address><hr><div align=center>
	1152	<table width=100% cellspacing=0 border=0><tr>
	1153	<td>Copyright © 2007
	1154	<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
	1155	<td align=right><div align=right>Qt 3.3.8</div>
	1156	</table></div></address></body>
	1157	</html>

Note: See TracBrowser for help on using the repository browser.

Context Navigation

source: trunk/doc/html/qstring-h.html

Download in other formats: