Context Navigation

qstring.html

Last change on this file was 190, checked in by rudi, 14 years ago
reference documentation added
File size: 144.8 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/src/tools/qstring.cpp:1228 -->
	3	<html>
	4	<head>
	5	<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
	6	<title>QString Class</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 Class Reference</h1>
	33
	34	<p>The QString class provides an abstraction of Unicode text
	35	and the classic C '\0'-terminated char array.
	36	<a href="#details">More...</a>
	37	<p>All the functions in this class are <a href="threads.html#reentrant">reentrant</a> when Qt is built with thread support.</p>
	38	<p><tt>#include <<a href="qstring-h.html">qstring.h</a>></tt>
	39	<p><a href="qstring-members.html">List of all member functions.</a>
	40	<h2>Public Members</h2>
	41	<ul>
	42	<li class=fn><a href="#QString"><b>QString</b></a> ()</li>
	43	<li class=fn><a href="#QString-2"><b>QString</b></a> ( QChar ch )</li>
	44	<li class=fn><a href="#QString-3"><b>QString</b></a> ( const QString & s )</li>
	45	<li class=fn><a href="#QString-4"><b>QString</b></a> ( const QByteArray & ba )</li>
	46	<li class=fn><a href="#QString-5"><b>QString</b></a> ( const QChar * unicode, uint length )</li>
	47	<li class=fn><a href="#QString-6"><b>QString</b></a> ( const char * str )</li>
	48	<li class=fn><a href="#QString-7"><b>QString</b></a> ( const std::string & str )</li>
	49	<li class=fn><a href="#~QString"><b>~QString</b></a> ()</li>
	50	<li class=fn>QString & <a href="#operator-eq-2"><b>operator=</b></a> ( const QString & s )</li>
	51	<li class=fn>QString & <a href="#operator-eq-3"><b>operator=</b></a> ( const char * str )</li>
	52	<li class=fn>QString & <a href="#operator-eq-4"><b>operator=</b></a> ( const std::string & s )</li>
	53	<li class=fn>QString & <a href="#operator-eq-5"><b>operator=</b></a> ( const QCString & cstr )</li>
	54	<li class=fn>QString & <a href="#operator-eq"><b>operator=</b></a> ( QChar c )</li>
	55	<li class=fn>QString & <a href="#operator-eq-6"><b>operator=</b></a> ( char c )</li>
	56	<li class=fn>bool <a href="#isNull"><b>isNull</b></a> () const</li>
	57	<li class=fn>bool <a href="#isEmpty"><b>isEmpty</b></a> () const</li>
	58	<li class=fn>uint <a href="#length"><b>length</b></a> () const</li>
	59	<li class=fn>void <a href="#truncate"><b>truncate</b></a> ( uint newLen )</li>
	60	<li class=fn>QString & <a href="#fill"><b>fill</b></a> ( QChar c, int len = -1 )</li>
	61	<li class=fn>QString copy () const  <em>(obsolete)</em></li>
	62	<li class=fn>QString <a href="#arg-2"><b>arg</b></a> ( long a, int fieldWidth = 0, int base = 10 ) const</li>
	63	<li class=fn>QString <a href="#arg-3"><b>arg</b></a> ( ulong a, int fieldWidth = 0, int base = 10 ) const</li>
	64	<li class=fn>QString <a href="#arg-4"><b>arg</b></a> ( Q_LLONG a, int fieldWidth = 0, int base = 10 ) const</li>
	65	<li class=fn>QString <a href="#arg-5"><b>arg</b></a> ( Q_ULLONG a, int fieldWidth = 0, int base = 10 ) const</li>
	66	<li class=fn>QString <a href="#arg-6"><b>arg</b></a> ( int a, int fieldWidth = 0, int base = 10 ) const</li>
	67	<li class=fn>QString <a href="#arg-7"><b>arg</b></a> ( uint a, int fieldWidth = 0, int base = 10 ) const</li>
	68	<li class=fn>QString <a href="#arg-8"><b>arg</b></a> ( short a, int fieldWidth = 0, int base = 10 ) const</li>
	69	<li class=fn>QString <a href="#arg-9"><b>arg</b></a> ( ushort a, int fieldWidth = 0, int base = 10 ) const</li>
	70	<li class=fn>QString <a href="#arg-a"><b>arg</b></a> ( double a, int fieldWidth = 0, char fmt = 'g', int prec = -1 ) const</li>
	71	<li class=fn>QString <a href="#arg-b"><b>arg</b></a> ( char a, int fieldWidth = 0 ) const</li>
	72	<li class=fn>QString <a href="#arg-c"><b>arg</b></a> ( QChar a, int fieldWidth = 0 ) const</li>
	73	<li class=fn>QString <a href="#arg"><b>arg</b></a> ( const QString & a, int fieldWidth = 0 ) const</li>
	74	<li class=fn>QString <a href="#arg-d"><b>arg</b></a> ( const QString & a1, const QString & a2 ) const</li>
	75	<li class=fn>QString <a href="#arg-e"><b>arg</b></a> ( const QString & a1, const QString & a2, const QString & a3 ) const</li>
	76	<li class=fn>QString <a href="#arg-f"><b>arg</b></a> ( const QString & a1, const QString & a2, const QString & a3, const QString & a4 ) const</li>
	77	<li class=fn>QString & <a href="#sprintf"><b>sprintf</b></a> ( const char * cformat, ... )</li>
	78	<li class=fn>int <a href="#find-2"><b>find</b></a> ( QChar c, int index = 0, bool cs = TRUE ) const</li>
	79	<li class=fn>int <a href="#find-3"><b>find</b></a> ( char c, int index = 0, bool cs = TRUE ) const</li>
	80	<li class=fn>int <a href="#find-4"><b>find</b></a> ( const QString & str, int index = 0, bool cs = TRUE ) const</li>
	81	<li class=fn>int <a href="#find"><b>find</b></a> ( const QRegExp & rx, int index = 0 ) const</li>
	82	<li class=fn>int <a href="#find-5"><b>find</b></a> ( const char * str, int index = 0 ) const</li>
	83	<li class=fn>int <a href="#findRev-2"><b>findRev</b></a> ( QChar c, int index = -1, bool cs = TRUE ) const</li>
	84	<li class=fn>int <a href="#findRev-3"><b>findRev</b></a> ( char c, int index = -1, bool cs = TRUE ) const</li>
	85	<li class=fn>int <a href="#findRev-4"><b>findRev</b></a> ( const QString & str, int index = -1, bool cs = TRUE ) const</li>
	86	<li class=fn>int <a href="#findRev-5"><b>findRev</b></a> ( const QRegExp & rx, int index = -1 ) const</li>
	87	<li class=fn>int <a href="#findRev"><b>findRev</b></a> ( const char * str, int index = -1 ) const</li>
	88	<li class=fn>int <a href="#contains"><b>contains</b></a> ( QChar c, bool cs = TRUE ) const</li>
	89	<li class=fn>int <a href="#contains-2"><b>contains</b></a> ( char c, bool cs = TRUE ) const</li>
	90	<li class=fn>int <a href="#contains-3"><b>contains</b></a> ( const char * str, bool cs = TRUE ) const</li>
	91	<li class=fn>int <a href="#contains-4"><b>contains</b></a> ( const QString & str, bool cs = TRUE ) const</li>
	92	<li class=fn>int <a href="#contains-5"><b>contains</b></a> ( const QRegExp & rx ) const</li>
	93	<li class=fn>enum <a href="#SectionFlags-enum"><b>SectionFlags</b></a> { SectionDefault = 0x00, SectionSkipEmpty = 0x01, SectionIncludeLeadingSep = 0x02, SectionIncludeTrailingSep = 0x04, SectionCaseInsensitiveSeps = 0x08 }</li>
	94	<li class=fn>QString <a href="#section"><b>section</b></a> ( QChar sep, int start, int end = 0xffffffff, int flags = SectionDefault ) const</li>
	95	<li class=fn>QString <a href="#section-2"><b>section</b></a> ( char sep, int start, int end = 0xffffffff, int flags = SectionDefault ) const</li>
	96	<li class=fn>QString <a href="#section-3"><b>section</b></a> ( const char * sep, int start, int end = 0xffffffff, int flags = SectionDefault ) const</li>
	97	<li class=fn>QString <a href="#section-4"><b>section</b></a> ( const QString & sep, int start, int end = 0xffffffff, int flags = SectionDefault ) const</li>
	98	<li class=fn>QString <a href="#section-5"><b>section</b></a> ( const QRegExp & reg, int start, int end = 0xffffffff, int flags = SectionDefault ) const</li>
	99	<li class=fn>QString <a href="#left"><b>left</b></a> ( uint len ) const</li>
	100	<li class=fn>QString <a href="#right"><b>right</b></a> ( uint len ) const</li>
	101	<li class=fn>QString <a href="#mid"><b>mid</b></a> ( uint index, uint len = 0xffffffff ) const</li>
	102	<li class=fn>QString <a href="#leftJustify"><b>leftJustify</b></a> ( uint width, QChar fill = ' ', bool truncate = FALSE ) const</li>
	103	<li class=fn>QString <a href="#rightJustify"><b>rightJustify</b></a> ( uint width, QChar fill = ' ', bool truncate = FALSE ) const</li>
	104	<li class=fn>QString <a href="#lower"><b>lower</b></a> () const</li>
	105	<li class=fn>QString <a href="#upper"><b>upper</b></a> () const</li>
	106	<li class=fn>QString <a href="#stripWhiteSpace"><b>stripWhiteSpace</b></a> () const</li>
	107	<li class=fn>QString <a href="#simplifyWhiteSpace"><b>simplifyWhiteSpace</b></a> () const</li>
	108	<li class=fn>QString & <a href="#insert"><b>insert</b></a> ( uint index, const QString & s )</li>
	109	<li class=fn>QString & <a href="#insert-2"><b>insert</b></a> ( uint index, const QByteArray & s )</li>
	110	<li class=fn>QString & <a href="#insert-3"><b>insert</b></a> ( uint index, const char * s )</li>
	111	<li class=fn>QString & <a href="#insert-4"><b>insert</b></a> ( uint index, const QChar * s, uint len )</li>
	112	<li class=fn>QString & <a href="#insert-5"><b>insert</b></a> ( uint index, QChar c )</li>
	113	<li class=fn>QString & <a href="#insert-6"><b>insert</b></a> ( uint index, char c )</li>
	114	<li class=fn>QString & <a href="#append-2"><b>append</b></a> ( char ch )</li>
	115	<li class=fn>QString & <a href="#append-3"><b>append</b></a> ( QChar ch )</li>
	116	<li class=fn>QString & <a href="#append"><b>append</b></a> ( const QString & str )</li>
	117	<li class=fn>QString & <a href="#append-4"><b>append</b></a> ( const QByteArray & str )</li>
	118	<li class=fn>QString & <a href="#append-5"><b>append</b></a> ( const char * str )</li>
	119	<li class=fn>QString & <a href="#append-6"><b>append</b></a> ( const std::string & str )</li>
	120	<li class=fn>QString & <a href="#prepend-2"><b>prepend</b></a> ( char ch )</li>
	121	<li class=fn>QString & <a href="#prepend-3"><b>prepend</b></a> ( QChar ch )</li>
	122	<li class=fn>QString & <a href="#prepend"><b>prepend</b></a> ( const QString & s )</li>
	123	<li class=fn>QString & <a href="#prepend-4"><b>prepend</b></a> ( const QByteArray & s )</li>
	124	<li class=fn>QString & <a href="#prepend-5"><b>prepend</b></a> ( const char * s )</li>
	125	<li class=fn>QString & <a href="#prepend-6"><b>prepend</b></a> ( const std::string & s )</li>
	126	<li class=fn>QString & <a href="#remove"><b>remove</b></a> ( uint index, uint len )</li>
	127	<li class=fn>QString & <a href="#remove-2"><b>remove</b></a> ( const QString & str, bool cs = TRUE )</li>
	128	<li class=fn>QString & <a href="#remove-3"><b>remove</b></a> ( QChar c )</li>
	129	<li class=fn>QString & <a href="#remove-4"><b>remove</b></a> ( char c )</li>
	130	<li class=fn>QString & <a href="#remove-5"><b>remove</b></a> ( const char * str )</li>
	131	<li class=fn>QString & <a href="#remove-6"><b>remove</b></a> ( const QRegExp & rx )</li>
	132	<li class=fn>QString & <a href="#replace"><b>replace</b></a> ( uint index, uint len, const QString & s )</li>
	133	<li class=fn>QString & <a href="#replace-2"><b>replace</b></a> ( uint index, uint len, const QChar * s, uint slen )</li>
	134	<li class=fn>QString & <a href="#replace-3"><b>replace</b></a> ( uint index, uint len, QChar c )</li>
	135	<li class=fn>QString & <a href="#replace-4"><b>replace</b></a> ( uint index, uint len, char c )</li>
	136	<li class=fn>QString & <a href="#replace-5"><b>replace</b></a> ( QChar c, const QString & after, bool cs = TRUE )</li>
	137	<li class=fn>QString & <a href="#replace-6"><b>replace</b></a> ( char c, const QString & after, bool cs = TRUE )</li>
	138	<li class=fn>QString & <a href="#replace-7"><b>replace</b></a> ( const QString & before, const QString & after, bool cs = TRUE )</li>
	139	<li class=fn>QString & <a href="#replace-8"><b>replace</b></a> ( const QRegExp & rx, const QString & after )</li>
	140	<li class=fn>QString & <a href="#replace-9"><b>replace</b></a> ( QChar c1, QChar c2 )</li>
	141	<li class=fn>short <a href="#toShort"><b>toShort</b></a> ( bool * ok = 0, int base = 10 ) const</li>
	142	<li class=fn>ushort <a href="#toUShort"><b>toUShort</b></a> ( bool * ok = 0, int base = 10 ) const</li>
	143	<li class=fn>int <a href="#toInt"><b>toInt</b></a> ( bool * ok = 0, int base = 10 ) const</li>
	144	<li class=fn>uint <a href="#toUInt"><b>toUInt</b></a> ( bool * ok = 0, int base = 10 ) const</li>
	145	<li class=fn>long <a href="#toLong"><b>toLong</b></a> ( bool * ok = 0, int base = 10 ) const</li>
	146	<li class=fn>ulong <a href="#toULong"><b>toULong</b></a> ( bool * ok = 0, int base = 10 ) const</li>
	147	<li class=fn>Q_LLONG <a href="#toLongLong"><b>toLongLong</b></a> ( bool * ok = 0, int base = 10 ) const</li>
	148	<li class=fn>Q_ULLONG <a href="#toULongLong"><b>toULongLong</b></a> ( bool * ok = 0, int base = 10 ) const</li>
	149	<li class=fn>float <a href="#toFloat"><b>toFloat</b></a> ( bool * ok = 0 ) const</li>
	150	<li class=fn>double <a href="#toDouble"><b>toDouble</b></a> ( bool * ok = 0 ) const</li>
	151	<li class=fn>QString & <a href="#setNum-2"><b>setNum</b></a> ( short n, int base = 10 )</li>
	152	<li class=fn>QString & <a href="#setNum-3"><b>setNum</b></a> ( ushort n, int base = 10 )</li>
	153	<li class=fn>QString & <a href="#setNum-4"><b>setNum</b></a> ( int n, int base = 10 )</li>
	154	<li class=fn>QString & <a href="#setNum-5"><b>setNum</b></a> ( uint n, int base = 10 )</li>
	155	<li class=fn>QString & <a href="#setNum-6"><b>setNum</b></a> ( long n, int base = 10 )</li>
	156	<li class=fn>QString & <a href="#setNum-7"><b>setNum</b></a> ( ulong n, int base = 10 )</li>
	157	<li class=fn>QString & <a href="#setNum"><b>setNum</b></a> ( Q_LLONG n, int base = 10 )</li>
	158	<li class=fn>QString & <a href="#setNum-8"><b>setNum</b></a> ( Q_ULLONG n, int base = 10 )</li>
	159	<li class=fn>QString & <a href="#setNum-9"><b>setNum</b></a> ( float n, char f = 'g', int prec = 6 )</li>
	160	<li class=fn>QString & <a href="#setNum-a"><b>setNum</b></a> ( double n, char f = 'g', int prec = 6 )</li>
	161	<li class=fn>void setExpand ( uint index, QChar c )  <em>(obsolete)</em></li>
	162	<li class=fn>QString & <a href="#operator+-eq"><b>operator+=</b></a> ( const QString & str )</li>
	163	<li class=fn>QString & <a href="#operator+-eq-2"><b>operator+=</b></a> ( const QByteArray & str )</li>
	164	<li class=fn>QString & <a href="#operator+-eq-3"><b>operator+=</b></a> ( const char * str )</li>
	165	<li class=fn>QString & <a href="#operator+-eq-4"><b>operator+=</b></a> ( const std::string & str )</li>
	166	<li class=fn>QString & <a href="#operator+-eq-5"><b>operator+=</b></a> ( QChar c )</li>
	167	<li class=fn>QString & <a href="#operator+-eq-6"><b>operator+=</b></a> ( char c )</li>
	168	<li class=fn>QChar <a href="#at"><b>at</b></a> ( uint i ) const</li>
	169	<li class=fn>QChar <a href="#operator[]"><b>operator[]</b></a> ( int i ) const</li>
	170	<li class=fn>QCharRef <a href="#at-2"><b>at</b></a> ( uint i )</li>
	171	<li class=fn>QCharRef <a href="#operator[]-2"><b>operator[]</b></a> ( int i )</li>
	172	<li class=fn>QChar <a href="#constref"><b>constref</b></a> ( uint i ) const</li>
	173	<li class=fn>QChar & <a href="#ref"><b>ref</b></a> ( uint i )</li>
	174	<li class=fn>const QChar * <a href="#unicode"><b>unicode</b></a> () const</li>
	175	<li class=fn>const char * <a href="#ascii"><b>ascii</b></a> () const</li>
	176	<li class=fn>const char * <a href="#latin1"><b>latin1</b></a> () const</li>
	177	<li class=fn>QCString <a href="#utf8"><b>utf8</b></a> () const</li>
	178	<li class=fn>QCString <a href="#local8Bit"><b>local8Bit</b></a> () const</li>
	179	<li class=fn>bool <a href="#operator!"><b>operator!</b></a> () const</li>
	180	<li class=fn><a href="#operator-const-char-"><b>operator const char </b></a> () const</li>
	181	<li class=fn><a href="#operator-std::string"><b>operator std::string</b></a> () const</li>
	182	<li class=fn>const unsigned short * <a href="#ucs2"><b>ucs2</b></a> () const</li>
	183	<li class=fn>QString & <a href="#setUnicode"><b>setUnicode</b></a> ( const QChar * unicode, uint len )</li>
	184	<li class=fn>QString & <a href="#setUnicodeCodes"><b>setUnicodeCodes</b></a> ( const ushort * unicode_as_ushorts, uint len )</li>
	185	<li class=fn>QString & <a href="#setAscii"><b>setAscii</b></a> ( const char * str, int len = -1 )</li>
	186	<li class=fn>QString & <a href="#setLatin1"><b>setLatin1</b></a> ( const char * str, int len = -1 )</li>
	187	<li class=fn>int <a href="#compare-2"><b>compare</b></a> ( const QString & s ) const</li>
	188	<li class=fn>int <a href="#localeAwareCompare-2"><b>localeAwareCompare</b></a> ( const QString & s ) const</li>
	189	<li class=fn>void <a href="#compose"><b>compose</b></a> ()</li>
	190	<li class=fn>const char * data () const  <em>(obsolete)</em></li>
	191	<li class=fn>bool <a href="#startsWith"><b>startsWith</b></a> ( const QString & s, bool cs = TRUE ) const</li>
	192	<li class=fn>bool <a href="#endsWith"><b>endsWith</b></a> ( const QString & s, bool cs = TRUE ) const</li>
	193	<li class=fn>void <a href="#setLength"><b>setLength</b></a> ( uint newLen )</li>
	194	<li class=fn>uint <a href="#capacity"><b>capacity</b></a> () const</li>
	195	<li class=fn>void <a href="#reserve"><b>reserve</b></a> ( uint minCapacity )</li>
	196	<li class=fn>void <a href="#squeeze"><b>squeeze</b></a> ()</li>
	197	</ul>
	198	<h2>Static Public Members</h2>
	199	<ul>
	200	<li class=fn>QString <a href="#number"><b>number</b></a> ( long n, int base = 10 )</li>
	201	<li class=fn>QString <a href="#number-2"><b>number</b></a> ( ulong n, int base = 10 )</li>
	202	<li class=fn>QString <a href="#number-3"><b>number</b></a> ( Q_LLONG n, int base = 10 )</li>
	203	<li class=fn>QString <a href="#number-4"><b>number</b></a> ( Q_ULLONG n, int base = 10 )</li>
	204	<li class=fn>QString <a href="#number-5"><b>number</b></a> ( int n, int base = 10 )</li>
	205	<li class=fn>QString <a href="#number-6"><b>number</b></a> ( uint n, int base = 10 )</li>
	206	<li class=fn>QString <a href="#number-7"><b>number</b></a> ( double n, char f = 'g', int prec = 6 )</li>
	207	<li class=fn>QString <a href="#fromAscii"><b>fromAscii</b></a> ( const char * ascii, int len = -1 )</li>
	208	<li class=fn>QString <a href="#fromLatin1"><b>fromLatin1</b></a> ( const char * chars, int len = -1 )</li>
	209	<li class=fn>QString <a href="#fromUtf8"><b>fromUtf8</b></a> ( const char * utf8, int len = -1 )</li>
	210	<li class=fn>QString <a href="#fromLocal8Bit"><b>fromLocal8Bit</b></a> ( const char * local8Bit, int len = -1 )</li>
	211	<li class=fn>QString <a href="#fromUcs2"><b>fromUcs2</b></a> ( const unsigned short * str )</li>
	212	<li class=fn>int <a href="#compare"><b>compare</b></a> ( const QString & s1, const QString & s2 )</li>
	213	<li class=fn>int <a href="#localeAwareCompare"><b>localeAwareCompare</b></a> ( const QString & s1, const QString & s2 )</li>
	214	</ul>
	215	<h2>Related Functions</h2>
	216	<ul>
	217	<li class=fn>bool <a href="#operator-eq-eq"><b>operator==</b></a> ( const QString & s1, const QString & s2 )</li>
	218	<li class=fn>bool <a href="#operator-eq-eq-2"><b>operator==</b></a> ( const QString & s1, const char * s2 )</li>
	219	<li class=fn>bool <a href="#operator-eq-eq-3"><b>operator==</b></a> ( const char * s1, const QString & s2 )</li>
	220	<li class=fn>bool <a href="#operator!-eq"><b>operator!=</b></a> ( const QString & s1, const QString & s2 )</li>
	221	<li class=fn>bool <a href="#operator!-eq-2"><b>operator!=</b></a> ( const QString & s1, const char * s2 )</li>
	222	<li class=fn>bool <a href="#operator!-eq-3"><b>operator!=</b></a> ( const char * s1, const QString & s2 )</li>
	223	<li class=fn>bool <a href="#operator-lt"><b>operator<</b></a> ( const QString & s1, const char * s2 )</li>
	224	<li class=fn>bool <a href="#operator-lt-2"><b>operator<</b></a> ( const char * s1, const QString & s2 )</li>
	225	<li class=fn>bool <a href="#operator-lt-eq"><b>operator<=</b></a> ( const QString & s1, const char * s2 )</li>
	226	<li class=fn>bool <a href="#operator-lt-eq-2"><b>operator<=</b></a> ( const char * s1, const QString & s2 )</li>
	227	<li class=fn>bool <a href="#operator-gt"><b>operator></b></a> ( const QString & s1, const char * s2 )</li>
	228	<li class=fn>bool <a href="#operator-gt-2"><b>operator></b></a> ( const char * s1, const QString & s2 )</li>
	229	<li class=fn>bool <a href="#operator-gt-eq"><b>operator>=</b></a> ( const QString & s1, const char * s2 )</li>
	230	<li class=fn>bool <a href="#operator-gt-eq-2"><b>operator>=</b></a> ( const char * s1, const QString & s2 )</li>
	231	<li class=fn>const QString <a href="#operator+"><b>operator+</b></a> ( const QString & s1, const QString & s2 )</li>
	232	<li class=fn>const QString <a href="#operator+-2"><b>operator+</b></a> ( const QString & s1, const char * s2 )</li>
	233	<li class=fn>const QString <a href="#operator+-3"><b>operator+</b></a> ( const char * s1, const QString & s2 )</li>
	234	<li class=fn>const QString <a href="#operator+-4"><b>operator+</b></a> ( const QString & s, char c )</li>
	235	<li class=fn>const QString <a href="#operator+-5"><b>operator+</b></a> ( char c, const QString & s )</li>
	236	<li class=fn>QDataStream & <a href="#operator-lt-lt"><b>operator<<</b></a> ( QDataStream & s, const QString & str )</li>
	237	<li class=fn>QDataStream & <a href="#operator-gt-gt"><b>operator>></b></a> ( QDataStream & s, QString & str )</li>
	238	</ul>
	239	<hr><a name="details"></a><h2>Detailed Description</h2>
	240
	241
	242
	243	<p> The QString class provides an abstraction of Unicode text
	244	and the classic C '\0'-terminated char array.
	245	<p>
	246
	247
	248
	249	<p> QString uses <a href="shclass.html">implicit sharing</a>, which
	250	makes it very efficient and easy to use.
	251	<p> In all of the QString methods that take <tt>const char *</tt>
	252	parameters, the <tt>const char *</tt> is interpreted as a classic
	253	C-style '\0'-terminated ASCII string. It is legal for the <tt>const char </tt> parameter to be 0. If the <tt>const char </tt> is not
	254	'\0'-terminated, the results are undefined. Functions that copy
	255	classic C strings into a QString will not copy the terminating
	256	'\0' character. The <a href="qchar.html">QChar</a> array of the QString (as returned by
	257	<a href="#unicode">unicode</a>()) is generally not terminated by a '\0'. If you need to
	258	pass a QString to a function that requires a C '\0'-terminated
	259	string use <a href="#latin1">latin1</a>().
	260	<p> <!-- index QString::null --><a name="QString-null"></a>A QString that has not been assigned to anything is <em>null</em>, i.e.
	261	both the length and data pointer is 0. A QString that references
	262	the empty string ("", a single '\0' char) is <em>empty</em>. Both null
	263	and empty QStrings are legal parameters to the methods. Assigning
	264	<tt>(const char *) 0</tt> to QString gives a null QString. For
	265	convenience, <a href="qstring.html#QString-null">QString::null</a> is a null QString. When sorting,
	266	empty strings come first, followed by non-empty strings, followed
	267	by null strings. We recommend using <tt>if ( !str.isNull() )</tt> to
	268	check for a non-null string rather than <tt>if ( !str )</tt>; see <a href="#operator!">operator!</a>() for an explanation.
	269	<p> Note that if you find that you are mixing usage of <a href="qcstring.html">QCString</a>,
	270	QString, and <a href="qbytearray.html">QByteArray</a>, this causes lots of unnecessary
	271	copying and might indicate that the true nature of the data you
	272	are dealing with is uncertain. If the data is '\0'-terminated 8-bit
	273	data, use <a href="qcstring.html">QCString</a>; if it is unterminated (i.e. contains '\0's)
	274	8-bit data, use <a href="qbytearray.html">QByteArray</a>; if it is text, use QString.
	275	<p> Lists of strings are handled by the <a href="qstringlist.html">QStringList</a> class. You can
	276	split a string into a list of strings using <a href="qstringlist.html#split">QStringList::split</a>(),
	277	and join a list of strings into a single string with an optional
	278	separator using <a href="qstringlist.html#join">QStringList::join</a>(). You can obtain a list of
	279	strings from a string list that contain a particular substring or
	280	that match a particular <a href="qregexp.html">regex</a> using
	281	<a href="qstringlist.html#grep">QStringList::grep</a>().
	282	<p> <b>Note for C programmers</b>
	283	<p> Due to C++'s type system and the fact that QString is <a href="shclass.html#implicitly-shared">implicitly shared</a>, QStrings can be treated like ints or other simple base
	284	types. For example:
	285	<p> <pre>
	286	QString boolToString( bool b )
	287	{
	288	QString result;
	289	if ( b )
	290	result = "True";
	291	else
	292	result = "False";
	293	return result;
	294	}
	295	</pre>
	296
	297	<p> The variable, result, is an auto variable allocated on the stack.
	298	When return is called, because we're returning by value, The copy
	299	constructor is called and a copy of the string is returned. (No
	300	actual copying takes place thanks to the <a href="shclass.html#implicit-sharing">implicit sharing</a>, see
	301	below.)
	302	<p> Throughout Qt's source code you will encounter QString usages like
	303	this:
	304	<pre>
	305	QString func( const QString& input )
	306	{
	307	QString output = input;
	308	// process output
	309	return output;
	310	}
	311	</pre>
	312
	313	<p> The 'copying' of input to output is almost as fast as copying a
	314	pointer because behind the scenes copying is achieved by
	315	incrementing a reference count. QString (like all Qt's implicitly
	316	shared classes) operates on a copy-on-write basis, only copying if
	317	an instance is actually changed.
	318	<p> If you wish to create a <a href="shclass.html#deep-copy">deep copy</a> of a QString without losing any
	319	Unicode information then you should use <a href="qdeepcopy.html">QDeepCopy</a>.
	320	<p> <p>See also <a href="qchar.html">QChar</a>, <a href="qcstring.html">QCString</a>, <a href="qbytearray.html">QByteArray</a>, <a href="qconststring.html">QConstString</a>, <a href="shared.html">Implicitly and Explicitly Shared Classes</a>, <a href="text.html">Text Related Classes</a>, and <a href="tools.html">Non-GUI Classes</a>.
	321
	322	<hr><h2>Member Type Documentation</h2>
	323	<h3 class=fn><a name="SectionFlags-enum"></a>QString::SectionFlags</h3>
	324
	325	<ul>
	326	<li><tt>QString::SectionDefault</tt> - Empty fields are counted, leading and
	327	trailing separators are not included, and the separator is
	328	compared case sensitively.
	329	<li><tt>QString::SectionSkipEmpty</tt> - Treat empty fields as if they don't exist,
	330	i.e. they are not considered as far as <em>start</em> and <em>end</em> are
	331	concerned.
	332	<li><tt>QString::SectionIncludeLeadingSep</tt> - Include the leading separator (if
	333	any) in the result string.
	334	<li><tt>QString::SectionIncludeTrailingSep</tt> - Include the trailing separator
	335	(if any) in the result string.
	336	<li><tt>QString::SectionCaseInsensitiveSeps</tt> - Compare the separator
	337	case-insensitively.
	338	</ul><p> Any of the last four values can be OR-ed together to form a flag.
	339	<p> <p>See also <a href="#section">section</a>().
	340
	341	<hr><h2>Member Function Documentation</h2>
	342	<h3 class=fn><a name="QString"></a>QString::QString ()
	343	</h3>
	344
	345	<p> Constructs a null string, i.e. both the length and data pointer
	346	are 0.
	347	<p> <p>See also <a href="#isNull">isNull</a>().
	348
	349	<h3 class=fn><a name="QString-2"></a>QString::QString ( <a href="qchar.html">QChar</a> ch )
	350	</h3>
	351	Constructs a string of length one, containing the character <em>ch</em>.
	352
	353	<h3 class=fn><a name="QString-3"></a>QString::QString ( const <a href="qstring.html">QString</a> & s )
	354	</h3>
	355	Constructs an <a href="shclass.html#implicitly-shared">implicitly shared</a> copy of <em>s</em>. This is very fast
	356	since it only involves incrementing a reference count.
	357
	358	<h3 class=fn><a name="QString-4"></a>QString::QString ( const <a href="qbytearray.html">QByteArray</a> & ba )
	359	</h3>
	360	Constructs a string that is a <a href="shclass.html#deep-copy">deep copy</a> of <em>ba</em> interpreted as a
	361	classic C string.
	362
	363	<h3 class=fn><a name="QString-5"></a>QString::QString ( const <a href="qchar.html">QChar</a> * unicode, uint length )
	364	</h3>
	365	Constructs a string that is a <a href="shclass.html#deep-copy">deep copy</a> of the first <em>length</em>
	366	characters in the <a href="qchar.html">QChar</a> array.
	367	<p> If <em>unicode</em> and <em>length</em> are 0, then a null string is created.
	368	<p> If only <em>unicode</em> is 0, the string is empty but has <em>length</em>
	369	characters of space preallocated: QString expands automatically
	370	anyway, but this may speed up some cases a little. We recommend
	371	using the plain constructor and <a href="#setLength">setLength</a>() for this purpose since
	372	it will result in more readable code.
	373	<p> <p>See also <a href="#isNull">isNull</a>() and <a href="#setLength">setLength</a>().
	374
	375	<h3 class=fn><a name="QString-6"></a>QString::QString ( const char * str )
	376	</h3>
	377	Constructs a string that is a <a href="shclass.html#deep-copy">deep copy</a> of <em>str</em>, interpreted as
	378	a classic C string. The encoding is assumed to be Latin-1, unless
	379	you change it using <a href="qtextcodec.html#setCodecForCStrings">QTextCodec::setCodecForCStrings</a>().
	380	<p> If <em>str</em> is 0, then a null string is created.
	381	<p> This is a cast constructor, but it is perfectly safe: converting a
	382	Latin-1 <tt>const char *</tt> to QString preserves all the information. You
	383	can disable this constructor by defining <tt>QT_NO_CAST_ASCII</tt> when
	384	you compile your applications. You can also make QString objects
	385	by using <a href="#setLatin1">setLatin1</a>(), <a href="#fromLatin1">fromLatin1</a>(), <a href="#fromLocal8Bit">fromLocal8Bit</a>(), and
	386	<a href="#fromUtf8">fromUtf8</a>(). Or whatever encoding is appropriate for the 8-bit data
	387	you have.
	388	<p> <p>See also <a href="#isNull">isNull</a>() and <a href="#fromAscii">fromAscii</a>().
	389
	390	<h3 class=fn><a name="QString-7"></a>QString::QString ( const std::string & str )
	391	</h3>
	392	Constructs a string that is a <a href="shclass.html#deep-copy">deep copy</a> of <em>str</em>.
	393	<p> This is the same as <a href="#fromAscii">fromAscii</a>(<em>str</em>).
	394
	395	<h3 class=fn><a name="~QString"></a>QString::~QString ()
	396	</h3>
	397
	398	<p> Destroys the string and frees the string's data if this is the
	399	last reference to the string.
	400
	401	<h3 class=fn><a href="qstring.html">QString</a> & <a name="append"></a>QString::append ( const <a href="qstring.html">QString</a> & str )
	402	</h3>
	403
	404	<p> Appends <em>str</em> to the string and returns a reference to the
	405	result.
	406	<p> <pre>
	407	string = "Test";
	408	string.append( "ing" ); // string == "Testing"
	409	</pre>
	410
	411	<p> Equivalent to <a href="#operator+-eq">operator+=</a>().
	412
	413	<p>Example: <a href="dirview-example.html#x1701">dirview/dirview.cpp</a>.
	414	<h3 class=fn><a href="qstring.html">QString</a> & <a name="append-2"></a>QString::append ( char ch )
	415	</h3>
	416
	417	<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	418	<p> Appends character <em>ch</em> to the string and returns a reference to
	419	the result.
	420	<p> Equivalent to <a href="#operator+-eq">operator+=</a>().
	421
	422	<h3 class=fn><a href="qstring.html">QString</a> & <a name="append-3"></a>QString::append ( <a href="qchar.html">QChar</a> ch )
	423	</h3>
	424
	425	<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	426	<p> Appends character <em>ch</em> to the string and returns a reference to
	427	the result.
	428	<p> Equivalent to <a href="#operator+-eq">operator+=</a>().
	429
	430	<h3 class=fn><a href="qstring.html">QString</a> & <a name="append-4"></a>QString::append ( const <a href="qbytearray.html">QByteArray</a> & str )
	431	</h3>
	432	This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	433	<p> Appends <em>str</em> to the string and returns a reference to the result.
	434	<p> Equivalent to <a href="#operator+-eq">operator+=</a>().
	435
	436	<h3 class=fn><a href="qstring.html">QString</a> & <a name="append-5"></a>QString::append ( const char * str )
	437	</h3>
	438	This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	439	<p> Appends <em>str</em> to the string and returns a reference to the result.
	440	<p> Equivalent to <a href="#operator+-eq">operator+=</a>().
	441
	442	<h3 class=fn><a href="qstring.html">QString</a> & <a name="append-6"></a>QString::append ( const std::string & str )
	443	</h3>
	444	This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	445	<p> Appends <em>str</em> to the string and returns a reference to the result.
	446	<p> Equivalent to <a href="#operator+-eq">operator+=</a>().
	447
	448	<h3 class=fn><a href="qstring.html">QString</a> <a name="arg"></a>QString::arg ( const <a href="qstring.html">QString</a> & a, int fieldWidth = 0 ) const
	449	</h3>
	450	This function will return a string that replaces the lowest
	451	numbered occurrence of <tt>%1</tt>, <tt>%2</tt>, ..., <tt>%9</tt> with <em>a</em>.
	452	<p> The <em>fieldWidth</em> value specifies the minimum amount of space that
	453	<em>a</em> is padded to. A positive value will produce right-aligned
	454	text, whereas a negative value will produce left-aligned text.
	455	<p> The following example shows how we could create a 'status' string
	456	when processing a list of files:
	457	<pre>
	458	QString status = <a href="#QString">QString</a>( "Processing file %1 of %2: %3" )
	459	.arg( i ) // current file's number
	460	.arg( total ) // number of files to process
	461	.arg( fileName ); // current file's name
	462	</pre>
	463
	464	<p> It is generally fine to use filenames and numbers as we have done
	465	in the example above. But note that using <a href="#arg">arg</a>() to construct
	466	natural language sentences does not usually translate well into
	467	other languages because sentence structure and word order often
	468	differ between languages.
	469	<p> If there is no place marker (<tt>%1</tt>, <tt>%2</tt>, etc.), a warning
	470	message (<a href="qapplication.html#qWarning">qWarning</a>()) is output and the result is undefined.
	471	<p> <b>Warning:</b> If any placeholder occurs more than once, the result is undefined.
	472	<p>
	473	<h3 class=fn><a href="qstring.html">QString</a> <a name="arg-2"></a>QString::arg ( long a, int fieldWidth = 0, int base = 10 ) const
	474	</h3>
	475	This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	476	<p> The <em>fieldWidth</em> value specifies the minimum amount of space that
	477	<em>a</em> is padded to. A positive value will produce a right-aligned
	478	number, whereas a negative value will produce a left-aligned
	479	number.
	480	<p> <em>a</em> is expressed in base <em>base</em>, which is 10 by default and must
	481	be between 2 and 36.
	482	<p> The '%' can be followed by an 'L', in which case the sequence is
	483	replaced with a localized representation of <em>a</em>. The conversion
	484	uses the default locale. The default locale is determined from the
	485	system's locale settings at application startup. It can be changed
	486	using <a href="qlocale.html#setDefault">QLocale::setDefault</a>(). The 'L' flag is ignored if <em>base</em> is
	487	not 10.
	488	<p> <pre>
	489	QString str;
	490	str = <a href="#QString">QString</a>( "Decimal 63 is %1 in hexadecimal" )
	491	.arg( 63, 0, 16 );
	492	// str == "Decimal 63 is 3f in hexadecimal"
	493
	494	QLocale::<a href="qlocale.html#setDefault">setDefault</a>(QLocale::English, QLocale::UnitedStates);
	495	str = <a href="#QString">QString</a>( "%1 %L2 %L3" )
	496	.arg( 12345 )
	497	.arg( 12345 )
	498	.arg( 12345, 0, 16 );
	499	// str == "12345 12,345 3039"
	500	</pre>
	501
	502
	503	<h3 class=fn><a href="qstring.html">QString</a> <a name="arg-3"></a>QString::arg ( ulong a, int fieldWidth = 0, int base = 10 ) const
	504	</h3>
	505	This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	506	<p> <em>a</em> is expressed in base <em>base</em>, which is 10 by default and must
	507	be between 2 and 36. If <em>base</em> is 10, the '%L' syntax can be used
	508	to produce localized strings.
	509
	510	<h3 class=fn><a href="qstring.html">QString</a> <a name="arg-4"></a>QString::arg ( Q_LLONG a, int fieldWidth = 0, int base = 10 ) const
	511	</h3>
	512	This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	513	<p> <em>a</em> is expressed in base <em>base</em>, which is 10 by default and must
	514	be between 2 and 36. If <em>base</em> is 10, the '%L' syntax can be used
	515	to produce localized strings.
	516
	517	<h3 class=fn><a href="qstring.html">QString</a> <a name="arg-5"></a>QString::arg ( Q_ULLONG a, int fieldWidth = 0, int base = 10 ) const
	518	</h3>
	519	This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	520	<p> <em>a</em> is expressed in base <em>base</em>, which is 10 by default and must
	521	be between 2 and 36. If <em>base</em> is 10, the '%L' syntax can be used
	522	to produce localized strings.
	523
	524	<h3 class=fn><a href="qstring.html">QString</a> <a name="arg-6"></a>QString::arg ( int a, int fieldWidth = 0, int base = 10 ) const
	525	</h3>
	526
	527	<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	528	<p> <em>a</em> is expressed in base <em>base</em>, which is 10 by default and must
	529	be between 2 and 36. If <em>base</em> is 10, the '%L' syntax can be used
	530	to produce localized strings.
	531
	532	<h3 class=fn><a href="qstring.html">QString</a> <a name="arg-7"></a>QString::arg ( uint a, int fieldWidth = 0, int base = 10 ) const
	533	</h3>
	534
	535	<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	536	<p> <em>a</em> is expressed in base <em>base</em>, which is 10 by default and must
	537	be between 2 and 36. If <em>base</em> is 10, the '%L' syntax can be used
	538	to produce localized strings.
	539
	540	<h3 class=fn><a href="qstring.html">QString</a> <a name="arg-8"></a>QString::arg ( short a, int fieldWidth = 0, int base = 10 ) const
	541	</h3>
	542
	543	<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	544	<p> <em>a</em> is expressed in base <em>base</em>, which is 10 by default and must
	545	be between 2 and 36. If <em>base</em> is 10, the '%L' syntax can be used
	546	to produce localized strings.
	547
	548	<h3 class=fn><a href="qstring.html">QString</a> <a name="arg-9"></a>QString::arg ( ushort a, int fieldWidth = 0, int base = 10 ) const
	549	</h3>
	550
	551	<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	552	<p> <em>a</em> is expressed in base <em>base</em>, which is 10 by default and must
	553	be between 2 and 36. If <em>base</em> is 10, the '%L' syntax can be used
	554	to produce localized strings.
	555
	556	<h3 class=fn><a href="qstring.html">QString</a> <a name="arg-a"></a>QString::arg ( double a, int fieldWidth = 0, char fmt = 'g', int prec = -1 ) const
	557	</h3>
	558	This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	559	<p> <a name="arg-formats"></a>
	560	<p> Argument <em>a</em> is formatted according to the <em>fmt</em> format specified,
	561	which is 'g' by default and can be any of the following:
	562	<p> <center><table cellpadding="4" cellspacing="2" border="0">
	563	<tr bgcolor="#a2c511"> <th valign="top">Format <th valign="top">Meaning
	564	<tr bgcolor="#f0f0f0"> <td valign="top"><tt>e</tt> <td valign="top">format as [-]9.9e[+\|-]999
	565	<tr bgcolor="#d0d0d0"> <td valign="top"><tt>E</tt> <td valign="top">format as [-]9.9E[+\|-]999
	566	<tr bgcolor="#f0f0f0"> <td valign="top"><tt>f</tt> <td valign="top">format as [-]9.9
	567	<tr bgcolor="#d0d0d0"> <td valign="top"><tt>g</tt> <td valign="top">use <tt>e</tt> or <tt>f</tt> format, whichever is the most concise
	568	<tr bgcolor="#f0f0f0"> <td valign="top"><tt>G</tt> <td valign="top">use <tt>E</tt> or <tt>f</tt> format, whichever is the most concise
	569	</table></center>
	570	<p> With 'e', 'E', and 'f', <em>prec</em> is the number of digits after the
	571	decimal point. With 'g' and 'G', <em>prec</em> is the maximum number of
	572	significant digits (trailing zeroes are omitted).
	573	<p> <pre>
	574	double d = 12.34;
	575	QString ds = <a href="#QString">QString</a>( "'E' format, precision 3, gives %1" )
	576	.arg( d, 0, 'E', 3 );
	577	// ds == "'E' format, precision 3, gives 1.234E+01"
	578	</pre>
	579
	580	<p> The '%L' syntax can be used to produce localized strings.
	581
	582	<h3 class=fn><a href="qstring.html">QString</a> <a name="arg-b"></a>QString::arg ( char a, int fieldWidth = 0 ) const
	583	</h3>
	584	This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	585	<p> <em>a</em> is assumed to be in the Latin-1 character set.
	586
	587	<h3 class=fn><a href="qstring.html">QString</a> <a name="arg-c"></a>QString::arg ( <a href="qchar.html">QChar</a> a, int fieldWidth = 0 ) const
	588	</h3>
	589	This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	590	<p>
	591	<h3 class=fn><a href="qstring.html">QString</a> <a name="arg-d"></a>QString::arg ( const <a href="qstring.html">QString</a> & a1, const <a href="qstring.html">QString</a> & a2 ) const
	592	</h3>
	593
	594	<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	595	<p> This is the same as str.<a href="#arg">arg</a>(<em>a1</em>).arg(<em>a2</em>), except that
	596	the strings are replaced in one pass. This can make a difference
	597	if <em>a1</em> contains e.g. <tt>%1</tt>:
	598	<p> <pre>
	599	QString str( "%1 %2" );
	600	str.<a href="#arg">arg</a>( "Hello", "world" ); // returns "Hello world"
	601	str.<a href="#arg">arg</a>( "Hello" ).arg( "world" ); // returns "Hello world"
	602
	603	str.<a href="#arg">arg</a>( "(%1)", "Hello" ); // returns "(%1) Hello"
	604	str.<a href="#arg">arg</a>( "(%1)" ).arg( "Hello" ); // returns "(Hello) %2"
	605	</pre>
	606
	607
	608	<h3 class=fn><a href="qstring.html">QString</a> <a name="arg-e"></a>QString::arg ( const <a href="qstring.html">QString</a> & a1, const <a href="qstring.html">QString</a> & a2, const <a href="qstring.html">QString</a> & a3 ) const
	609	</h3>
	610
	611	This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	612	<p> This is the same as calling str.<a href="#arg">arg</a>(<em>a1</em>).arg(<em>a2</em>).arg(<em>a3</em>),
	613	except that the strings are replaced in one pass.
	614
	615	<h3 class=fn><a href="qstring.html">QString</a> <a name="arg-f"></a>QString::arg ( const <a href="qstring.html">QString</a> & a1, const <a href="qstring.html">QString</a> & a2, const <a href="qstring.html">QString</a> & a3, const <a href="qstring.html">QString</a> & a4 ) const
	616	</h3>
	617
	618	This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	619	<p> This is the same as calling
	620	str.<a href="#arg">arg</a>(<em>a1</em>).arg(<em>a2</em>).arg(<em>a3</em>).arg(<em>a4</em>),
	621	except that the strings are replaced in one pass.
	622
	623	<h3 class=fn>const char * <a name="ascii"></a>QString::ascii () const
	624	</h3>
	625	Returns an 8-bit ASCII representation of the string.
	626	<p> If a codec has been set using <a href="qtextcodec.html#codecForCStrings">QTextCodec::codecForCStrings</a>(),
	627	it is used to convert Unicode to 8-bit char. Otherwise, this function
	628	does the same as <a href="#latin1">latin1</a>().
	629	<p> <p>See also <a href="#fromAscii">fromAscii</a>(), <a href="#latin1">latin1</a>(), <a href="#utf8">utf8</a>(), and <a href="#local8Bit">local8Bit</a>().
	630
	631	<p>Example: <a href="networkprotocol-example.html#x690">network/networkprotocol/nntp.cpp</a>.
	632	<h3 class=fn><a href="qchar.html">QChar</a> <a name="at"></a>QString::at ( uint i ) const
	633	</h3>
	634
	635	<p> Returns the character at index <em>i</em>, or 0 if <em>i</em> is beyond the
	636	length of the string.
	637	<p> <pre>
	638	const QString string( "abcdefgh" );
	639	<a href="qchar.html">QChar</a> ch = string.<a href="#at">at</a>( 4 );
	640	// ch == 'e'
	641	</pre>
	642
	643	<p> If the QString is not const (i.e. const QString) or const& (i.e.
	644	const QString &), then the non-const overload of <a href="#at">at</a>() will be used
	645	instead.
	646
	647	<h3 class=fn><a href="qcharref.html">QCharRef</a> <a name="at-2"></a>QString::at ( uint i )
	648	</h3>
	649
	650	<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	651	<p> The function returns a reference to the character at index <em>i</em>.
	652	The resulting reference can then be assigned to, or used
	653	immediately, but it will become invalid once further modifications
	654	are made to the original string.
	655	<p> If <em>i</em> is beyond the length of the string then the string is
	656	expanded with QChar::null.
	657
	658	<h3 class=fn>uint <a name="capacity"></a>QString::capacity () const
	659	</h3>
	660
	661	<p> Returns the number of characters this string can hold
	662	in the allocated memory.
	663	<p> <p>See also <a href="#reserve">reserve</a>() and <a href="#squeeze">squeeze</a>().
	664
	665	<h3 class=fn>int <a name="compare"></a>QString::compare ( const <a href="qstring.html">QString</a> & s1, const <a href="qstring.html">QString</a> & s2 )<tt> [static]</tt>
	666	</h3>
	667
	668	<p> Lexically compares <em>s1</em> with <em>s2</em> and returns an integer less
	669	than, equal to, or greater than zero if <em>s1</em> is less than, equal
	670	to, or greater than <em>s2</em>.
	671	<p> The comparison is based exclusively on the numeric Unicode values
	672	of the characters and is very fast, but is not what a human would
	673	expect. Consider sorting user-interface strings with
	674	<a href="#localeAwareCompare">QString::localeAwareCompare</a>().
	675	<p> <pre>
	676	int a = QString::<a href="#compare">compare</a>( "def", "abc" ); // a > 0
	677	int b = QString::<a href="#compare">compare</a>( "abc", "def" ); // b < 0
	678	int c = QString::<a href="#compare">compare</a>( "abc", "abc" ); // c == 0
	679	</pre>
	680
	681
	682	<h3 class=fn>int <a name="compare-2"></a>QString::compare ( const <a href="qstring.html">QString</a> & s ) const
	683	</h3>
	684	This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	685	<p> Lexically compares this string with <em>s</em> and returns an integer
	686	less than, equal to, or greater than zero if it is less than, equal
	687	to, or greater than <em>s</em>.
	688
	689	<h3 class=fn>void <a name="compose"></a>QString::compose ()
	690	</h3>
	691	<b>Warning:</b> This function is not supported in Qt 3.x. It is provided
	692	for experimental and illustrative purposes only. It is mainly of
	693	interest to those experimenting with Arabic and other
	694	composition-rich texts.
	695	<p> Applies possible ligatures to a QString. Useful when
	696	composition-rich text requires rendering with glyph-poor fonts,
	697	but it also makes compositions such as <a href="qchar.html">QChar</a>(0x0041) ('A') and
	698	QChar(0x0308) (Unicode accent diaresis), giving QChar(0x00c4)
	699	(German A Umlaut).
	700
	701	<h3 class=fn><a href="qchar.html">QChar</a> <a name="constref"></a>QString::constref ( uint i ) const
	702	</h3>
	703
	704	<p> Returns the <a href="qchar.html">QChar</a> at index <em>i</em> by value.
	705	<p> Equivalent to <a href="#at">at</a>(<em>i</em>).
	706	<p> <p>See also <a href="#ref">ref</a>().
	707
	708	<h3 class=fn>int <a name="contains"></a>QString::contains ( <a href="qchar.html">QChar</a> c, bool cs = TRUE ) const
	709	</h3>
	710	Returns the number of times the character <em>c</em> occurs in the
	711	string.
	712	<p> If <em>cs</em> is TRUE (the default), the search is case sensitive;
	713	otherwise the search is case insensitive.
	714	<p> <pre>
	715	QString string( "Trolltech and Qt" );
	716	int n = string.<a href="#contains">contains</a>( 't', FALSE );
	717	// n == 3
	718	</pre>
	719
	720
	721	<p>Examples: <a href="fileiconview-example.html#x867">fileiconview/qfileiconview.cpp</a> and <a href="mdi-example.html#x2064">mdi/application.cpp</a>.
	722	<h3 class=fn>int <a name="contains-2"></a>QString::contains ( char c, bool cs = TRUE ) const
	723	</h3>
	724
	725	<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	726	<p>
	727	<h3 class=fn>int <a name="contains-3"></a>QString::contains ( const char * str, bool cs = TRUE ) const
	728	</h3>
	729	This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	730	<p> Returns the number of times the string <em>str</em> occurs in the string.
	731	<p> If <em>cs</em> is TRUE (the default), the search is case sensitive;
	732	otherwise the search is case insensitive.
	733
	734	<h3 class=fn>int <a name="contains-4"></a>QString::contains ( const <a href="qstring.html">QString</a> & str, bool cs = TRUE ) const
	735	</h3>
	736	This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	737	<p> Returns the number of times <em>str</em> occurs in the string.
	738	<p> If <em>cs</em> is TRUE (the default), the search is case sensitive;
	739	otherwise the search is case insensitive.
	740	<p> This function counts overlapping strings, so in the example below,
	741	there are two instances of "ana" in "bananas".
	742	<p> <pre>
	743	QString str( "bananas" );
	744	int i = str.<a href="#contains">contains</a>( "ana" ); // i == 2
	745	</pre>
	746
	747	<p> <p>See also <a href="#findRev">findRev</a>().
	748
	749	<h3 class=fn>int <a name="contains-5"></a>QString::contains ( const <a href="qregexp.html">QRegExp</a> & rx ) const
	750	</h3>
	751	This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	752	<p> Returns the number of times the regexp, <em>rx</em>, matches in the
	753	string.
	754	<p> This function counts overlapping matches, so in the example below,
	755	there are four instances of "ana" or "ama".
	756	<p> <pre>
	757	QString str = "banana and panama";
	758	<a href="qregexp.html">QRegExp</a> rxp = QRegExp( "a[nm]a", TRUE, FALSE );
	759	int i = str.<a href="#contains">contains</a>( rxp ); // i == 4
	760	</pre>
	761
	762	<p> <p>See also <a href="#find">find</a>() and <a href="#findRev">findRev</a>().
	763
	764	<h3 class=fn><a href="qstring.html">QString</a> <a name="copy"></a>QString::copy () const
	765	</h3>
	766
	767	<p> <b>This function is obsolete.</b> It is provided to keep old source working. We strongly advise against using it in new code.
	768	<p> In Qt 2.0 and later, all calls to this function are needless. Just
	769	remove them.
	770
	771	<h3 class=fn>const char * <a name="data"></a>QString::data () const
	772	</h3>
	773
	774	<p> <b>This function is obsolete.</b> It is provided to keep old source working. We strongly advise against using it in new code.
	775	<p> Returns a pointer to a '\0'-terminated classic C string.
	776	<p> In Qt 1.x, this returned a char* allowing direct manipulation of the
	777	string as a sequence of bytes. In Qt 2.x where QString is a Unicode
	778	string, char* conversion constructs a temporary string, and hence
	779	direct character operations are meaningless.
	780
	781	<h3 class=fn>bool <a name="endsWith"></a>QString::endsWith ( const <a href="qstring.html">QString</a> & s, bool cs = TRUE ) const
	782	</h3>
	783	Returns TRUE if the string ends with <em>s</em>; otherwise returns
	784	FALSE.
	785	<p> If <em>cs</em> is TRUE (the default), the search is case sensitive;
	786	otherwise the search is case insensitive.
	787	<p> <pre>
	788	QString str( "Bananas" );
	789	str.<a href="#endsWith">endsWith</a>( "anas" ); // returns TRUE
	790	str.<a href="#endsWith">endsWith</a>( "pple" ); // returns FALSE
	791	</pre>
	792
	793	<p> <p>See also <a href="#startsWith">startsWith</a>().
	794
	795	<p>Example: <a href="tutorial2-04.html#x2561">chart/main.cpp</a>.
	796	<h3 class=fn><a href="qstring.html">QString</a> & <a name="fill"></a>QString::fill ( <a href="qchar.html">QChar</a> c, int len = -1 )
	797	</h3>
	798	Fills the string with <em>len</em> characters of value <em>c</em>, and returns
	799	a reference to the string.
	800	<p> If <em>len</em> is negative (the default), the current string length is
	801	used.
	802	<p> <pre>
	803	QString str;
	804	str.<a href="#fill">fill</a>( 'g', 5 ); // string == "ggggg"
	805	</pre>
	806
	807
	808	<h3 class=fn>int <a name="find"></a>QString::find ( const <a href="qregexp.html">QRegExp</a> & rx, int index = 0 ) const
	809	</h3>
	810	Finds the first match of the <a href="qregexp.html#regular-expression">regular expression</a> <em>rx</em>, starting
	811	from position <em>index</em>. If <em>index</em> is -1, the search starts at
	812	the last character; if -2, at the next to last character and so
	813	on. (See <a href="#findRev">findRev</a>() for searching backwards.)
	814	<p> Returns the position of the first match of <em>rx</em> or -1 if no match
	815	was found.
	816	<p> <pre>
	817	QString string( "bananas" );
	818	int i = string.<a href="#find">find</a>( QRegExp("an"), 0 ); // i == 1
	819	</pre>
	820
	821	<p> <p>See also <a href="#findRev">findRev</a>(), <a href="#replace">replace</a>(), and <a href="#contains">contains</a>().
	822
	823	<p>Example: <a href="mail-example.html#x715">network/mail/smtp.cpp</a>.
	824	<h3 class=fn>int <a name="find-2"></a>QString::find ( <a href="qchar.html">QChar</a> c, int index = 0, bool cs = TRUE ) const
	825	</h3>
	826	This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	827	<p> Finds the first occurrence of the character <em>c</em>, starting at
	828	position <em>index</em>. If <em>index</em> is -1, the search starts at the
	829	last character; if -2, at the next to last character and so on.
	830	(See <a href="#findRev">findRev</a>() for searching backwards.)
	831	<p> If <em>cs</em> is TRUE (the default), the search is case sensitive;
	832	otherwise the search is case insensitive.
	833	<p> Returns the position of <em>c</em> or -1 if <em>c</em> could not be found.
	834
	835	<h3 class=fn>int <a name="find-3"></a>QString::find ( char c, int index = 0, bool cs = TRUE ) const
	836	</h3>
	837
	838	<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	839	<p> Find character <em>c</em> starting from position <em>index</em>.
	840	<p> If <em>cs</em> is TRUE (the default), the search is case sensitive;
	841	otherwise the search is case insensitive.
	842
	843	<h3 class=fn>int <a name="find-4"></a>QString::find ( const <a href="qstring.html">QString</a> & str, int index = 0, bool cs = TRUE ) const
	844	</h3>
	845	This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	846	<p> Finds the first occurrence of the string <em>str</em>, starting at
	847	position <em>index</em>. If <em>index</em> is -1, the search starts at the
	848	last character, if it is -2, at the next to last character and so
	849	on. (See <a href="#findRev">findRev</a>() for searching backwards.)
	850	<p> If <em>cs</em> is TRUE (the default), the search is case sensitive;
	851	otherwise the search is case insensitive.
	852	<p> Returns the position of <em>str</em> or -1 if <em>str</em> could not be found.
	853
	854	<h3 class=fn>int <a name="find-5"></a>QString::find ( const char * str, int index = 0 ) const
	855	</h3>
	856
	857	<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	858	<p> Equivalent to <a href="#find">find</a>(QString(<em>str</em>), <em>index</em>).
	859
	860	<h3 class=fn>int <a name="findRev"></a>QString::findRev ( const char * str, int index = -1 ) const
	861	</h3>
	862
	863	<p> Equivalent to <a href="#findRev">findRev</a>(QString(<em>str</em>), <em>index</em>).
	864
	865	<h3 class=fn>int <a name="findRev-2"></a>QString::findRev ( <a href="qchar.html">QChar</a> c, int index = -1, bool cs = TRUE ) const
	866	</h3>
	867	This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	868	<p> Finds the first occurrence of the character <em>c</em>, starting at
	869	position <em>index</em> and searching backwards. If the index is -1, the
	870	search starts at the last character, if it is -2, at the next to
	871	last character and so on.
	872	<p> Returns the position of <em>c</em> or -1 if <em>c</em> could not be found.
	873	<p> If <em>cs</em> is TRUE (the default), the search is case sensitive;
	874	otherwise the search is case insensitive.
	875	<p> <pre>
	876	QString string( "bananas" );
	877	int i = string.<a href="#findRev">findRev</a>( 'a' ); // i == 5
	878	</pre>
	879
	880
	881	<h3 class=fn>int <a name="findRev-3"></a>QString::findRev ( char c, int index = -1, bool cs = TRUE ) const
	882	</h3>
	883
	884	<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	885	<p> Find character <em>c</em> starting from position <em>index</em> and working
	886	backwards.
	887	<p> If <em>cs</em> is TRUE (the default), the search is case sensitive;
	888	otherwise the search is case insensitive.
	889
	890	<h3 class=fn>int <a name="findRev-4"></a>QString::findRev ( const <a href="qstring.html">QString</a> & str, int index = -1, bool cs = TRUE ) const
	891	</h3>
	892	This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	893	<p> Finds the first occurrence of the string <em>str</em>, starting at
	894	position <em>index</em> and searching backwards. If the index is -1, the
	895	search starts at the last character, if it is -2, at the next to
	896	last character and so on.
	897	<p> Returns the position of <em>str</em> or -1 if <em>str</em> could not be found.
	898	<p> If <em>cs</em> is TRUE (the default), the search is case sensitive;
	899	otherwise the search is case insensitive.
	900	<p> <pre>
	901	QString string("bananas");
	902	int i = string.<a href="#findRev">findRev</a>( "ana" ); // i == 3
	903	</pre>
	904
	905
	906	<h3 class=fn>int <a name="findRev-5"></a>QString::findRev ( const <a href="qregexp.html">QRegExp</a> & rx, int index = -1 ) const
	907	</h3>
	908	This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	909	<p> Finds the first match of the regexp <em>rx</em>, starting at position <em>index</em> and searching backwards. If the index is -1, the search
	910	starts at the last character, if it is -2, at the next to last
	911	character and so on. (See <a href="#findRev">findRev</a>() for searching backwards.)
	912	<p> Returns the position of the match or -1 if no match was found.
	913	<p> <pre>
	914	QString string( "bananas" );
	915	int i = string.<a href="#findRev">findRev</a>( QRegExp("an") ); // i == 3
	916	</pre>
	917
	918	<p> <p>See also <a href="#find">find</a>().
	919
	920	<h3 class=fn><a href="qstring.html">QString</a> <a name="fromAscii"></a>QString::fromAscii ( const char * ascii, int len = -1 )<tt> [static]</tt>
	921	</h3>
	922	Returns the Unicode string decoded from the first <em>len</em>
	923	bytes of <em>ascii</em>, ignoring the rest of <em>ascii</em>. If <em>len</em>
	924	is -1 then the length of <em>ascii</em> is used. If <em>len</em> is bigger
	925	than the length of <em>ascii</em> then it will use the length of <em>ascii</em>.
	926	<p> If a codec has been set using <a href="qtextcodec.html#codecForCStrings">QTextCodec::codecForCStrings</a>(),
	927	it is used to convert the string from 8-bit characters to Unicode.
	928	Otherwise, this function does the same as <a href="#fromLatin1">fromLatin1</a>().
	929	<p> This is the same as the QString(const char*) constructor, but you
	930	can make that constructor invisible if you compile with the define
	931	<tt>QT_NO_CAST_ASCII</tt>, in which case you can explicitly create a
	932	QString from 8-bit ASCII text using this function.
	933	<p> <pre>
	934	QString str = QString::<a href="#fromAscii">fromAscii</a>( "123456789", 5 );
	935	// str == "12345"
	936	</pre>
	937
	938
	939	<h3 class=fn><a href="qstring.html">QString</a> <a name="fromLatin1"></a>QString::fromLatin1 ( const char * chars, int len = -1 )<tt> [static]</tt>
	940	</h3>
	941	Returns the Unicode string decoded from the first <em>len</em>
	942	bytes of <em>chars</em>, ignoring the rest of <em>chars</em>. If <em>len</em>
	943	is -1 then the length of <em>chars</em> is used. If <em>len</em> is bigger
	944	than the length of <em>chars</em> then it will use the length of <em>chars</em>.
	945	<p> <p>See also <a href="#fromAscii">fromAscii</a>().
	946
	947	<p>Examples: <a href="listbox-example.html#x1446">listbox/listbox.cpp</a> and <a href="mail-example.html#x716">network/mail/smtp.cpp</a>.
	948	<h3 class=fn><a href="qstring.html">QString</a> <a name="fromLocal8Bit"></a>QString::fromLocal8Bit ( const char * local8Bit, int len = -1 )<tt> [static]</tt>
	949	</h3>
	950	Returns the Unicode string decoded from the first <em>len</em>
	951	bytes of <em>local8Bit</em>, ignoring the rest of <em>local8Bit</em>. If
	952	<em>len</em> is -1 then the length of <em>local8Bit</em> is used. If <em>len</em> is
	953	bigger than the length of <em>local8Bit</em> then it will use the length
	954	of <em>local8Bit</em>.
	955	<p> <pre>
	956	QString str = QString::<a href="#fromLocal8Bit">fromLocal8Bit</a>( "123456789", 5 );
	957	// str == "12345"
	958	</pre>
	959
	960	<p> <em>local8Bit</em> is assumed to be encoded in a locale-specific format.
	961	<p> See <a href="qtextcodec.html">QTextCodec</a> for more diverse coding/decoding of Unicode strings.
	962
	963	<h3 class=fn><a href="qstring.html">QString</a> <a name="fromUcs2"></a>QString::fromUcs2 ( const unsigned short * str )<tt> [static]</tt>
	964	</h3>
	965	Constructs a string that is a <a href="shclass.html#deep-copy">deep copy</a> of <em>str</em>, interpreted as a
	966	UCS2 encoded, zero terminated, Unicode string.
	967	<p> If <em>str</em> is 0, then a null string is created.
	968	<p> <p>See also <a href="#isNull">isNull</a>().
	969
	970	<h3 class=fn><a href="qstring.html">QString</a> <a name="fromUtf8"></a>QString::fromUtf8 ( const char * utf8, int len = -1 )<tt> [static]</tt>
	971	</h3>
	972	Returns the Unicode string decoded from the first <em>len</em>
	973	bytes of <em>utf8</em>, ignoring the rest of <em>utf8</em>. If <em>len</em> is
	974	-1 then the length of <em>utf8</em> is used. If <em>len</em> is bigger than
	975	the length of <em>utf8</em> then it will use the length of <em>utf8</em>.
	976	<p> <pre>
	977	QString str = QString::<a href="#fromUtf8">fromUtf8</a>( "123456789", 5 );
	978	// str == "12345"
	979	</pre>
	980
	981	<p> See <a href="qtextcodec.html">QTextCodec</a> for more diverse coding/decoding of Unicode strings.
	982
	983	<p>Example: <a href="simple-font-demo-example.html#x2850">fonts/simple-qfont-demo/viewer.cpp</a>.
	984	<h3 class=fn><a href="qstring.html">QString</a> & <a name="insert"></a>QString::insert ( uint index, const <a href="qstring.html">QString</a> & s )
	985	</h3>
	986	Inserts <em>s</em> into the string at position <em>index</em>.
	987	<p> If <em>index</em> is beyond the end of the string, the string is
	988	extended with spaces to length <em>index</em> and <em>s</em> is then appended
	989	and returns a reference to the string.
	990	<p> <pre>
	991	QString string( "I like fish" );
	992	str = string.<a href="#insert">insert</a>( 2, "don't " );
	993	// str == "I don't like fish"
	994	</pre>
	995
	996	<p> <p>See also <a href="#remove">remove</a>() and <a href="#replace">replace</a>().
	997
	998	<p>Examples: <a href="themes-example.html#x337">themes/themes.cpp</a> and <a href="xform-example.html#x1264">xform/xform.cpp</a>.
	999	<h3 class=fn><a href="qstring.html">QString</a> & <a name="insert-2"></a>QString::insert ( uint index, const <a href="qbytearray.html">QByteArray</a> & s )
	1000	</h3>
	1001	This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	1002	<p> Inserts <em>s</em> into the string at position <em>index</em> and returns
	1003	a reference to the string.
	1004
	1005	<h3 class=fn><a href="qstring.html">QString</a> & <a name="insert-3"></a>QString::insert ( uint index, const char * s )
	1006	</h3>
	1007	This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	1008	<p> Inserts <em>s</em> into the string at position <em>index</em> and returns
	1009	a reference to the string.
	1010
	1011	<h3 class=fn><a href="qstring.html">QString</a> & <a name="insert-4"></a>QString::insert ( uint index, const <a href="qchar.html">QChar</a> * s, uint len )
	1012	</h3>
	1013	This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	1014	<p> Inserts the first <em>len</em> characters in <em>s</em> into the string at
	1015	position <em>index</em> and returns a reference to the string.
	1016
	1017	<h3 class=fn><a href="qstring.html">QString</a> & <a name="insert-5"></a>QString::insert ( uint index, <a href="qchar.html">QChar</a> c )
	1018	</h3>
	1019	This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	1020	<p> Insert <em>c</em> into the string at position <em>index</em> and returns a
	1021	reference to the string.
	1022	<p> If <em>index</em> is beyond the end of the string, the string is
	1023	extended with spaces (ASCII 32) to length <em>index</em> and <em>c</em> is
	1024	then appended.
	1025
	1026	<h3 class=fn><a href="qstring.html">QString</a> & <a name="insert-6"></a>QString::insert ( uint index, char c )
	1027	</h3>
	1028
	1029	<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	1030	<p> Insert character <em>c</em> at position <em>index</em>.
	1031
	1032	<h3 class=fn>bool <a name="isEmpty"></a>QString::isEmpty () const
	1033	</h3>
	1034
	1035	<p> Returns TRUE if the string is empty, i.e. if <a href="#length">length</a>() == 0;
	1036	otherwise returns FALSE. Null strings are also empty.
	1037	<p> <pre>
	1038	QString a( "" );
	1039	a.<a href="#isEmpty">isEmpty</a>(); // TRUE
	1040	a.<a href="#isNull">isNull</a>(); // FALSE
	1041
	1042	QString b;
	1043	b.<a href="#isEmpty">isEmpty</a>(); // TRUE
	1044	b.<a href="#isNull">isNull</a>(); // TRUE
	1045	</pre>
	1046
	1047	<p> <p>See also <a href="#isNull">isNull</a>() and <a href="#length">length</a>().
	1048
	1049	<p>Examples: <a href="addressbook-example.html#x571">addressbook/mainwindow.cpp</a>, <a href="canvas-chart-example.html#x2892">chart/chartform.cpp</a>, <a href="tutorial2-06.html#x2576">chart/chartform_canvas.cpp</a>, <a href="networkprotocol-example.html#x691">network/networkprotocol/nntp.cpp</a>, <a href="qmag-example.html#x1792">qmag/qmag.cpp</a>, and <a href="qwerty-example.html#x390">qwerty/qwerty.cpp</a>.
	1050	<h3 class=fn>bool <a name="isNull"></a>QString::isNull () const
	1051	</h3>
	1052
	1053	<p> Returns TRUE if the string is null; otherwise returns FALSE. A
	1054	null string is always empty.
	1055	<p> <pre>
	1056	QString a; // a.<a href="#unicode">unicode</a>() == 0, a.<a href="#length">length</a>() == 0
	1057	a.<a href="#isNull">isNull</a>(); // TRUE, because a.<a href="#unicode">unicode</a>() == 0
	1058	a.<a href="#isEmpty">isEmpty</a>(); // TRUE, because a.<a href="#length">length</a>() == 0
	1059	</pre>
	1060
	1061	<p> <p>See also <a href="#isEmpty">isEmpty</a>() and <a href="#length">length</a>().
	1062
	1063	<p>Examples: <a href="i18n-example.html#x1948">i18n/main.cpp</a>, <a href="ftpclient-example.html#x771">network/ftpclient/ftpmainwindow.ui.h</a>, and <a href="qdir-example.html#x1842">qdir/qdir.cpp</a>.
	1064	<h3 class=fn>const char * <a name="latin1"></a>QString::latin1 () const
	1065	</h3>
	1066	Returns a Latin-1 representation of the string. The
	1067	returned value is undefined if the string contains non-Latin-1
	1068	characters. If you want to convert strings into formats other than
	1069	Unicode, see the <a href="qtextcodec.html">QTextCodec</a> classes.
	1070	<p> This function is mainly useful for boot-strapping legacy code to
	1071	use Unicode.
	1072	<p> The result remains valid so long as one unmodified copy of the
	1073	source string exists.
	1074	<p> <p>See also <a href="#fromLatin1">fromLatin1</a>(), <a href="#ascii">ascii</a>(), <a href="#utf8">utf8</a>(), and <a href="#local8Bit">local8Bit</a>().
	1075
	1076	<p>Examples: <a href="fileiconview-example.html#x869">fileiconview/qfileiconview.cpp</a> and <a href="networkprotocol-example.html#x692">network/networkprotocol/nntp.cpp</a>.
	1077	<h3 class=fn><a href="qstring.html">QString</a> <a name="left"></a>QString::left ( uint len ) const
	1078	</h3>
	1079	Returns a substring that contains the <em>len</em> leftmost characters
	1080	of the string.
	1081	<p> The whole string is returned if <em>len</em> exceeds the length of the
	1082	string.
	1083	<p> <pre>
	1084	QString s = "Pineapple";
	1085	QString t = s.<a href="#left">left</a>( 4 ); // t == "Pine"
	1086	</pre>
	1087
	1088	<p> <p>See also <a href="#right">right</a>(), <a href="#mid">mid</a>(), and <a href="#isEmpty">isEmpty</a>().
	1089
	1090	<p>Example: <a href="themes-example.html#x338">themes/themes.cpp</a>.
	1091	<h3 class=fn><a href="qstring.html">QString</a> <a name="leftJustify"></a>QString::leftJustify ( uint width, <a href="qchar.html">QChar</a> fill = ' ', bool truncate = FALSE ) const
	1092	</h3>
	1093	Returns a string of length <em>width</em> that contains this string
	1094	padded by the <em>fill</em> character.
	1095	<p> If <em>truncate</em> is FALSE and the length of the string is more than
	1096	<em>width</em>, then the returned string is a copy of the string.
	1097	<p> If <em>truncate</em> is TRUE and the length of the string is more than
	1098	<em>width</em>, then any characters in a copy of the string after length
	1099	<em>width</em> are removed, and the copy is returned.
	1100	<p> <pre>
	1101	QString s( "apple" );
	1102	QString t = s.<a href="#leftJustify">leftJustify</a>( 8, '.' ); // t == "apple..."
	1103	</pre>
	1104
	1105	<p> <p>See also <a href="#rightJustify">rightJustify</a>().
	1106
	1107	<h3 class=fn>uint <a name="length"></a>QString::length () const
	1108	</h3>
	1109
	1110	<p> Returns the length of the string.
	1111	<p> Null strings and empty strings have zero length.
	1112	<p> <p>See also <a href="#isNull">isNull</a>() and <a href="#isEmpty">isEmpty</a>().
	1113
	1114	<p>Examples: <a href="dirview-example.html#x1702">dirview/dirview.cpp</a>, <a href="fileiconview-example.html#x870">fileiconview/qfileiconview.cpp</a>, <a href="networkprotocol-example.html#x693">network/networkprotocol/nntp.cpp</a>, <a href="rot-example.html#x1372">rot13/rot13.cpp</a>, and <a href="themes-example.html#x339">themes/themes.cpp</a>.
	1115	<h3 class=fn><a href="qcstring.html">QCString</a> <a name="local8Bit"></a>QString::local8Bit () const
	1116	</h3>
	1117	Returns the string encoded in a locale-specific format. On X11,
	1118	this is the <a href="qtextcodec.html#codecForLocale">QTextCodec::codecForLocale</a>(). On Windows, it is a
	1119	system-defined encoding. On Mac OS X, this always uses UTF-8 as
	1120	the encoding.
	1121	<p> See <a href="qtextcodec.html">QTextCodec</a> for more diverse coding/decoding of Unicode
	1122	strings.
	1123	<p> <p>See also <a href="#fromLocal8Bit">fromLocal8Bit</a>(), <a href="#ascii">ascii</a>(), <a href="#latin1">latin1</a>(), and <a href="#utf8">utf8</a>().
	1124
	1125	<h3 class=fn>int <a name="localeAwareCompare"></a>QString::localeAwareCompare ( const <a href="qstring.html">QString</a> & s1, const <a href="qstring.html">QString</a> & s2 )<tt> [static]</tt>
	1126	</h3>
	1127
	1128	<p> Compares <em>s1</em> with <em>s2</em> and returns an integer less than, equal
	1129	to, or greater than zero if <em>s1</em> is less than, equal to, or
	1130	greater than <em>s2</em>.
	1131	<p> The comparison is performed in a locale- and also
	1132	platform-dependent manner. Use this function to present sorted
	1133	lists of strings to the user.
	1134	<p> <p>See also <a href="#compare">QString::compare</a>() and <a href="qtextcodec.html#locale">QTextCodec::locale</a>().
	1135
	1136	<h3 class=fn>int <a name="localeAwareCompare-2"></a>QString::localeAwareCompare ( const <a href="qstring.html">QString</a> & s ) const
	1137	</h3>
	1138	This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	1139	<p> Compares this string with <em>s</em>.
	1140
	1141	<h3 class=fn><a href="qstring.html">QString</a> <a name="lower"></a>QString::lower () const
	1142	</h3>
	1143	Returns a lowercase copy of the string.
	1144	<p> <pre>
	1145	QString string( "TROlltECH" );
	1146	str = string.<a href="#lower">lower</a>(); // str == "trolltech"
	1147	</pre>
	1148
	1149	<p> <p>See also <a href="#upper">upper</a>().
	1150
	1151	<p>Example: <a href="scribble-example.html#x941">scribble/scribble.cpp</a>.
	1152	<h3 class=fn><a href="qstring.html">QString</a> <a name="mid"></a>QString::mid ( uint index, uint len = 0xffffffff ) const
	1153	</h3>
	1154	Returns a string that contains the <em>len</em> characters of this
	1155	string, starting at position <em>index</em>.
	1156	<p> Returns a null string if the string is empty or <em>index</em> is out of
	1157	range. Returns the whole string from <em>index</em> if <em>index</em> + <em>len</em>
	1158	exceeds the length of the string.
	1159	<p> <pre>
	1160	QString s( "Five pineapples" );
	1161	QString t = s.<a href="#mid">mid</a>( 5, 4 ); // t == "pine"
	1162	</pre>
	1163
	1164	<p> <p>See also <a href="#left">left</a>() and <a href="#right">right</a>().
	1165
	1166	<p>Examples: <a href="mail-example.html#x717">network/mail/smtp.cpp</a>, <a href="qmag-example.html#x1793">qmag/qmag.cpp</a>, and <a href="themes-example.html#x340">themes/themes.cpp</a>.
	1167	<h3 class=fn><a href="qstring.html">QString</a> <a name="number"></a>QString::number ( long n, int base = 10 )<tt> [static]</tt>
	1168	</h3>
	1169	A convenience function that returns a string equivalent of the
	1170	number <em>n</em> to base <em>base</em>, which is 10 by default and must be
	1171	between 2 and 36. The returned string is in "C" locale.
	1172	<p> <pre>
	1173	long a = 63;
	1174	QString str = QString::<a href="#number">number</a>( a, 16 ); // str == "3f"
	1175	QString str = QString::<a href="#number">number</a>( a, 16 ).upper(); // str == "3F"
	1176	</pre>
	1177
	1178	<p> <p>See also <a href="#setNum">setNum</a>().
	1179
	1180	<p>Examples: <a href="simple-application-example.html#x1580">application/application.cpp</a>, <a href="canvas-chart-example.html#x2893">chart/chartform.cpp</a>, <a href="simple-font-demo-example.html#x2851">fonts/simple-qfont-demo/viewer.cpp</a>, <a href="helpviewer-example.html#x1018">helpviewer/helpwindow.cpp</a>, <a href="mdi-example.html#x2066">mdi/application.cpp</a>, <a href="regexptester-example.html#x2496">regexptester/regexptester.cpp</a>, and <a href="sql.html#x2193">sql/overview/extract/main.cpp</a>.
	1181	<h3 class=fn><a href="qstring.html">QString</a> <a name="number-2"></a>QString::number ( ulong n, int base = 10 )<tt> [static]</tt>
	1182	</h3>
	1183	This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	1184	<p> <p>See also <a href="#setNum">setNum</a>().
	1185
	1186	<h3 class=fn><a href="qstring.html">QString</a> <a name="number-3"></a>QString::number ( Q_LLONG n, int base = 10 )<tt> [static]</tt>
	1187	</h3>
	1188	This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	1189	<p> <p>See also <a href="#setNum">setNum</a>().
	1190
	1191	<h3 class=fn><a href="qstring.html">QString</a> <a name="number-4"></a>QString::number ( Q_ULLONG n, int base = 10 )<tt> [static]</tt>
	1192	</h3>
	1193	This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	1194	<p> <p>See also <a href="#setNum">setNum</a>().
	1195
	1196	<h3 class=fn><a href="qstring.html">QString</a> <a name="number-5"></a>QString::number ( int n, int base = 10 )<tt> [static]</tt>
	1197	</h3>
	1198	This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	1199	<p> <p>See also <a href="#setNum">setNum</a>().
	1200
	1201	<h3 class=fn><a href="qstring.html">QString</a> <a name="number-6"></a>QString::number ( uint n, int base = 10 )<tt> [static]</tt>
	1202	</h3>
	1203	This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	1204	<p> A convenience factory function that returns a string
	1205	representation of the number <em>n</em> to the base <em>base</em>, which is 10
	1206	by default and must be between 2 and 36.
	1207	<p> <p>See also <a href="#setNum">setNum</a>().
	1208
	1209	<h3 class=fn><a href="qstring.html">QString</a> <a name="number-7"></a>QString::number ( double n, char f = 'g', int prec = 6 )<tt> [static]</tt>
	1210	</h3>
	1211	This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	1212	<p> Argument <em>n</em> is formatted according to the <em>f</em> format specified,
	1213	which is <tt>g</tt> by default, and can be any of the following:
	1214	<p> <center><table cellpadding="4" cellspacing="2" border="0">
	1215	<tr bgcolor="#a2c511"> <th valign="top">Format <th valign="top">Meaning
	1216	<tr bgcolor="#f0f0f0"> <td valign="top"><tt>e</tt> <td valign="top">format as [-]9.9e[+\|-]999
	1217	<tr bgcolor="#d0d0d0"> <td valign="top"><tt>E</tt> <td valign="top">format as [-]9.9E[+\|-]999
	1218	<tr bgcolor="#f0f0f0"> <td valign="top"><tt>f</tt> <td valign="top">format as [-]9.9
	1219	<tr bgcolor="#d0d0d0"> <td valign="top"><tt>g</tt> <td valign="top">use <tt>e</tt> or <tt>f</tt> format, whichever is the most concise
	1220	<tr bgcolor="#f0f0f0"> <td valign="top"><tt>G</tt> <td valign="top">use <tt>E</tt> or <tt>f</tt> format, whichever is the most concise
	1221	</table></center>
	1222	<p> With 'e', 'E', and 'f', <em>prec</em> is the number of digits after the
	1223	decimal point. With 'g' and 'G', <em>prec</em> is the maximum number of
	1224	significant digits (trailing zeroes are omitted).
	1225	<p> <pre>
	1226	double d = 12.34;
	1227	QString ds = <a href="#QString">QString</a>( "'E' format, precision 3, gives %1" )
	1228	.arg( d, 0, 'E', 3 );
	1229	// ds == "1.234E+001"
	1230	</pre>
	1231
	1232	<p> <p>See also <a href="#setNum">setNum</a>().
	1233
	1234	<h3 class=fn><a name="operator-const-char-"></a>QString::operator const char () const
	1235	</h3>
	1236
	1237	<p> Returns <a href="#ascii">ascii</a>(). Be sure to see the warnings documented in the
	1238	ascii() function. Note that for new code which you wish to be
	1239	strictly Unicode-clean, you can define the macro <tt>QT_NO_ASCII_CAST</tt> when compiling your code to hide this function so
	1240	that automatic casts are not done. This has the added advantage
	1241	that you catch the programming error described in <a href="#operator!">operator!</a>().
	1242
	1243	<h3 class=fn><a name="operator-std::string"></a>QString::operator std::string () const
	1244	</h3>
	1245
	1246	<p> Returns <a href="#ascii">ascii</a>() as a std::string.
	1247	<p> <b>Warning:</b> The function may cause an application to crash if a static C run-time is in use.
	1248	This can happen in Microsoft Visual C++ if Qt is configured as single-threaded. A safe
	1249	alternative is to call ascii() directly and construct a std::string manually.
	1250
	1251	<h3 class=fn>bool <a name="operator!"></a>QString::operator! () const
	1252	</h3>
	1253
	1254	<p> Returns TRUE if this is a null string; otherwise returns FALSE.
	1255	<p> <pre>
	1256	QString name = getName();
	1257	if ( !name )
	1258	name = "Rodney";
	1259	</pre>
	1260
	1261	<p> Note that if you say
	1262	<p> <pre>
	1263	QString name = getName();
	1264	if ( name )
	1265	doSomethingWith(name);
	1266	</pre>
	1267
	1268	<p> It will call "operator const char*()", which is inefficent; you
	1269	may wish to define the macro <tt>QT_NO_ASCII_CAST</tt> when writing code
	1270	which you wish to remain Unicode-clean.
	1271	<p> When you want the above semantics, use:
	1272	<p> <pre>
	1273	QString name = getName();
	1274	if ( !name.<a href="#isNull">isNull</a>() )
	1275	doSomethingWith(name);
	1276	</pre>
	1277
	1278	<p> <p>See also <a href="#isEmpty">isEmpty</a>().
	1279
	1280	<h3 class=fn><a href="qstring.html">QString</a> & <a name="operator+-eq"></a>QString::operator+= ( const <a href="qstring.html">QString</a> & str )
	1281	</h3>
	1282	Appends <em>str</em> to the string and returns a reference to the string.
	1283
	1284	<h3 class=fn><a href="qstring.html">QString</a> & <a name="operator+-eq-2"></a>QString::operator+= ( const <a href="qbytearray.html">QByteArray</a> & str )
	1285	</h3>
	1286
	1287	This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	1288	<p> Appends <em>str</em> to the string and returns a reference to the string.
	1289
	1290	<h3 class=fn><a href="qstring.html">QString</a> & <a name="operator+-eq-3"></a>QString::operator+= ( const char * str )
	1291	</h3>
	1292	This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	1293	<p> Appends <em>str</em> to the string and returns a reference to the string.
	1294
	1295	<h3 class=fn><a href="qstring.html">QString</a> & <a name="operator+-eq-4"></a>QString::operator+= ( const std::string & str )
	1296	</h3>
	1297
	1298	This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	1299	<p> Appends <em>str</em> to the string and returns a reference to the string.
	1300
	1301	<h3 class=fn><a href="qstring.html">QString</a> & <a name="operator+-eq-5"></a>QString::operator+= ( <a href="qchar.html">QChar</a> c )
	1302	</h3> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	1303	<p> Appends <em>c</em> to the string and returns a reference to the string.
	1304
	1305	<h3 class=fn><a href="qstring.html">QString</a> & <a name="operator+-eq-6"></a>QString::operator+= ( char c )
	1306	</h3>
	1307	This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	1308	<p> Appends <em>c</em> to the string and returns a reference to the string.
	1309
	1310	<h3 class=fn><a href="qstring.html">QString</a> & <a name="operator-eq"></a>QString::operator= ( <a href="qchar.html">QChar</a> c )
	1311	</h3>
	1312
	1313	<p> Sets the string to contain just the single character <em>c</em>.
	1314
	1315	<h3 class=fn><a href="qstring.html">QString</a> & <a name="operator-eq-2"></a>QString::operator= ( const <a href="qstring.html">QString</a> & s )
	1316	</h3>
	1317	This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	1318	<p> Assigns a <a href="shclass.html#shallow-copy">shallow copy</a> of <em>s</em> to this string and returns a
	1319	reference to this string. This is very fast because the string
	1320	isn't actually copied.
	1321
	1322	<h3 class=fn><a href="qstring.html">QString</a> & <a name="operator-eq-3"></a>QString::operator= ( const char * str )
	1323	</h3>
	1324	This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	1325	<p> Assigns a <a href="shclass.html#deep-copy">deep copy</a> of <em>str</em>, interpreted as a classic C string
	1326	to this string and returns a reference to this string.
	1327	<p> If <em>str</em> is 0, then a null string is created.
	1328	<p> <p>See also <a href="#isNull">isNull</a>().
	1329
	1330	<h3 class=fn><a href="qstring.html">QString</a> & <a name="operator-eq-4"></a>QString::operator= ( const std::string & s )
	1331	</h3>
	1332
	1333	<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	1334	<p> Makes a <a href="shclass.html#deep-copy">deep copy</a> of <em>s</em> and returns a reference to the deep
	1335	copy.
	1336
	1337	<h3 class=fn><a href="qstring.html">QString</a> & <a name="operator-eq-5"></a>QString::operator= ( const <a href="qcstring.html">QCString</a> & cstr )
	1338	</h3>
	1339	This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	1340	<p> Assigns a <a href="shclass.html#deep-copy">deep copy</a> of <em>cstr</em>, interpreted as a classic C
	1341	string, to this string. Returns a reference to this string.
	1342
	1343	<h3 class=fn><a href="qstring.html">QString</a> & <a name="operator-eq-6"></a>QString::operator= ( char c )
	1344	</h3>
	1345
	1346	<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	1347	<p> Sets the string to contain just the single character <em>c</em>.
	1348
	1349	<h3 class=fn><a href="qchar.html">QChar</a> <a name="operator[]"></a>QString::operator[] ( int i ) const
	1350	</h3>
	1351
	1352	<p> Returns the character at index <em>i</em>, or QChar::null if <em>i</em> is
	1353	beyond the length of the string.
	1354	<p> If the QString is not const (i.e., const QString) or const&
	1355	(i.e., const QString&), then the non-const overload of operator[]
	1356	will be used instead.
	1357
	1358	<h3 class=fn><a href="qcharref.html">QCharRef</a> <a name="operator[]-2"></a>QString::operator[] ( int i )
	1359	</h3>
	1360
	1361	<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	1362	<p> The function returns a reference to the character at index <em>i</em>.
	1363	The resulting reference can then be assigned to, or used
	1364	immediately, but it will become invalid once further modifications
	1365	are made to the original string.
	1366	<p> If <em>i</em> is beyond the length of the string then the string is
	1367	expanded with QChar::nulls, so that the <a href="qcharref.html">QCharRef</a> references a
	1368	valid (null) character in the string.
	1369	<p> The QCharRef internal class can be used much like a constant
	1370	<a href="qchar.html">QChar</a>, but if you assign to it, you change the original string
	1371	(which will detach itself because of QString's copy-on-write
	1372	semantics). You will get compilation errors if you try to use the
	1373	result as anything but a QChar.
	1374
	1375	<h3 class=fn><a href="qstring.html">QString</a> & <a name="prepend"></a>QString::prepend ( const <a href="qstring.html">QString</a> & s )
	1376	</h3>
	1377
	1378	<p> Inserts <em>s</em> at the beginning of the string and returns a
	1379	reference to the string.
	1380	<p> Equivalent to <a href="#insert">insert</a>(0, <em>s</em>).
	1381	<p> <pre>
	1382	QString string = "42";
	1383	string.<a href="#prepend">prepend</a>( "The answer is " );
	1384	// string == "The answer is 42"
	1385	</pre>
	1386
	1387	<p> <p>See also <a href="#insert">insert</a>().
	1388
	1389	<h3 class=fn><a href="qstring.html">QString</a> & <a name="prepend-2"></a>QString::prepend ( char ch )
	1390	</h3>
	1391
	1392	<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	1393	<p> Inserts <em>ch</em> at the beginning of the string and returns a
	1394	reference to the string.
	1395	<p> Equivalent to <a href="#insert">insert</a>(0, <em>ch</em>).
	1396	<p> <p>See also <a href="#insert">insert</a>().
	1397
	1398	<h3 class=fn><a href="qstring.html">QString</a> & <a name="prepend-3"></a>QString::prepend ( <a href="qchar.html">QChar</a> ch )
	1399	</h3>
	1400
	1401	<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	1402	<p> Inserts <em>ch</em> at the beginning of the string and returns a
	1403	reference to the string.
	1404	<p> Equivalent to <a href="#insert">insert</a>(0, <em>ch</em>).
	1405	<p> <p>See also <a href="#insert">insert</a>().
	1406
	1407	<h3 class=fn><a href="qstring.html">QString</a> & <a name="prepend-4"></a>QString::prepend ( const <a href="qbytearray.html">QByteArray</a> & s )
	1408	</h3>
	1409	This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	1410	<p> Inserts <em>s</em> at the beginning of the string and returns a reference to the string.
	1411	<p> Equivalent to <a href="#insert">insert</a>(0, <em>s</em>).
	1412	<p> <p>See also <a href="#insert">insert</a>().
	1413
	1414	<h3 class=fn><a href="qstring.html">QString</a> & <a name="prepend-5"></a>QString::prepend ( const char * s )
	1415	</h3>
	1416	This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	1417	<p> Inserts <em>s</em> at the beginning of the string and returns a reference to the string.
	1418	<p> Equivalent to <a href="#insert">insert</a>(0, <em>s</em>).
	1419	<p> <p>See also <a href="#insert">insert</a>().
	1420
	1421	<h3 class=fn><a href="qstring.html">QString</a> & <a name="prepend-6"></a>QString::prepend ( const std::string & s )
	1422	</h3>
	1423	This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	1424	<p> Inserts <em>s</em> at the beginning of the string and returns a reference to the string.
	1425	<p> Equivalent to <a href="#insert">insert</a>(0, <em>s</em>).
	1426	<p> <p>See also <a href="#insert">insert</a>().
	1427
	1428	<h3 class=fn><a href="qchar.html">QChar</a> & <a name="ref"></a>QString::ref ( uint i )
	1429	</h3>
	1430
	1431	<p> Returns the <a href="qchar.html">QChar</a> at index <em>i</em> by reference, expanding the string
	1432	with QChar::null if necessary. The resulting reference can be
	1433	assigned to, or otherwise used immediately, but becomes invalid
	1434	once furher modifications are made to the string.
	1435	<p> <pre>
	1436	QString string("ABCDEF");
	1437	<a href="qchar.html">QChar</a> ch = string.<a href="#ref">ref</a>( 3 ); // ch == 'D'
	1438	</pre>
	1439
	1440	<p> <p>See also <a href="#constref">constref</a>().
	1441
	1442	<h3 class=fn><a href="qstring.html">QString</a> & <a name="remove"></a>QString::remove ( uint index, uint len )
	1443	</h3>
	1444	Removes <em>len</em> characters from the string starting at position <em>index</em>, and returns a reference to the string.
	1445	<p> If <em>index</em> is beyond the length of the string, nothing happens.
	1446	If <em>index</em> is within the string, but <em>index</em> + <em>len</em> is beyond
	1447	the end of the string, the string is truncated at position <em>index</em>.
	1448	<p> <pre>
	1449	QString string( "Montreal" );
	1450	string.<a href="#remove">remove</a>( 1, 4 ); // string == "Meal"
	1451	</pre>
	1452
	1453	<p> <p>See also <a href="#insert">insert</a>() and <a href="#replace">replace</a>().
	1454
	1455	<h3 class=fn><a href="qstring.html">QString</a> & <a name="remove-2"></a>QString::remove ( const <a href="qstring.html">QString</a> & str, bool cs = TRUE )
	1456	</h3> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	1457	<p> Removes every occurrence of <em>str</em> in the string. Returns a
	1458	reference to the string.
	1459	<p> If <em>cs</em> is TRUE (the default), the search is case sensitive;
	1460	otherwise the search is case insensitive.
	1461	<p> This is the same as <a href="#replace">replace</a>(<em>str</em>, "", <em>cs</em>).
	1462
	1463	<h3 class=fn><a href="qstring.html">QString</a> & <a name="remove-3"></a>QString::remove ( <a href="qchar.html">QChar</a> c )
	1464	</h3> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	1465	<p> Removes every occurrence of the character <em>c</em> in the string.
	1466	Returns a reference to the string.
	1467	<p> This is the same as <a href="#replace">replace</a>(<em>c</em>, "").
	1468
	1469	<h3 class=fn><a href="qstring.html">QString</a> & <a name="remove-4"></a>QString::remove ( char c )
	1470	</h3> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	1471	<p>
	1472	<p> Removes every occurrence of the character <em>c</em> in the string.
	1473	Returns a reference to the string.
	1474	<p> This is the same as <a href="#replace">replace</a>(<em>c</em>, "").
	1475
	1476	<h3 class=fn><a href="qstring.html">QString</a> & <a name="remove-5"></a>QString::remove ( const char * str )
	1477	</h3>
	1478	This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	1479	<p> Removes every occurrence of <em>str</em> in the string. Returns a
	1480	reference to the string.
	1481
	1482	<h3 class=fn><a href="qstring.html">QString</a> & <a name="remove-6"></a>QString::remove ( const <a href="qregexp.html">QRegExp</a> & rx )
	1483	</h3> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	1484	<p> Removes every occurrence of the <a href="qregexp.html#regular-expression">regular expression</a> <em>rx</em> in the
	1485	string. Returns a reference to the string.
	1486	<p> This is the same as <a href="#replace">replace</a>(<em>rx</em>, "").
	1487
	1488	<h3 class=fn><a href="qstring.html">QString</a> & <a name="replace"></a>QString::replace ( uint index, uint len, const <a href="qstring.html">QString</a> & s )
	1489	</h3>
	1490	Replaces <em>len</em> characters from the string with <em>s</em>, starting at
	1491	position <em>index</em>, and returns a reference to the string.
	1492	<p> If <em>index</em> is beyond the length of the string, nothing is deleted
	1493	and <em>s</em> is appended at the end of the string. If <em>index</em> is
	1494	valid, but <em>index</em> + <em>len</em> is beyond the end of the string,
	1495	the string is truncated at position <em>index</em>, then <em>s</em> is
	1496	appended at the end.
	1497	<p> <pre>
	1498	QString string( "Say yes!" );
	1499	string = string.<a href="#replace">replace</a>( 4, 3, "NO" );
	1500	// string == "Say NO!"
	1501	</pre>
	1502
	1503	<p> <b>Warning:</b> Qt 3.3.3 and earlier had different semantics for the
	1504	case <em>index</em> >= <a href="#length">length</a>(), which contradicted the documentation.
	1505	To avoid portability problems between Qt 3 versions and with Qt
	1506	4, we recommend that you never call the function with <em>index</em> >=
	1507	length().
	1508	<p> <p>See also <a href="#insert">insert</a>() and <a href="#remove">remove</a>().
	1509
	1510	<p>Examples: <a href="listviews-example.html#x162">listviews/listviews.cpp</a>, <a href="networkprotocol-example.html#x694">network/networkprotocol/nntp.cpp</a>, <a href="qmag-example.html#x1794">qmag/qmag.cpp</a>, and <a href="regexptester-example.html#x2497">regexptester/regexptester.cpp</a>.
	1511	<h3 class=fn><a href="qstring.html">QString</a> & <a name="replace-2"></a>QString::replace ( uint index, uint len, const <a href="qchar.html">QChar</a> * s, uint slen )
	1512	</h3>
	1513	This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	1514	<p> Replaces <em>len</em> characters with <em>slen</em> characters of <a href="qchar.html">QChar</a> data
	1515	from <em>s</em>, starting at position <em>index</em>, and returns a reference
	1516	to the string.
	1517	<p> <p>See also <a href="#insert">insert</a>() and <a href="#remove">remove</a>().
	1518
	1519	<h3 class=fn><a href="qstring.html">QString</a> & <a name="replace-3"></a>QString::replace ( uint index, uint len, <a href="qchar.html">QChar</a> c )
	1520	</h3> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	1521	<p> This is the same as <a href="#replace">replace</a>(<em>index</em>, <em>len</em>, QString(<em>c</em>)).
	1522
	1523	<h3 class=fn><a href="qstring.html">QString</a> & <a name="replace-4"></a>QString::replace ( uint index, uint len, char c )
	1524	</h3> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	1525	<p>
	1526	<p> This is the same as <a href="#replace">replace</a>(<em>index</em>, <em>len</em>, <a href="qchar.html">QChar</a>(<em>c</em>)).
	1527
	1528	<h3 class=fn><a href="qstring.html">QString</a> & <a name="replace-5"></a>QString::replace ( <a href="qchar.html">QChar</a> c, const <a href="qstring.html">QString</a> & after, bool cs = TRUE )
	1529	</h3> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	1530	<p> Replaces every occurrence of the character <em>c</em> in the string
	1531	with <em>after</em>. Returns a reference to the string.
	1532	<p> If <em>cs</em> is TRUE (the default), the search is case sensitive;
	1533	otherwise the search is case insensitive.
	1534	<p> Example:
	1535	<pre>
	1536	QString s = "a,b,c";
	1537	s.<a href="#replace">replace</a>( QChar(','), " or " );
	1538	// s == "a or b or c"
	1539	</pre>
	1540
	1541
	1542	<h3 class=fn><a href="qstring.html">QString</a> & <a name="replace-6"></a>QString::replace ( char c, const <a href="qstring.html">QString</a> & after, bool cs = TRUE )
	1543	</h3> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	1544	<p>
	1545	<p> Replaces every occurrence of the character <em>c</em> in the string
	1546	with <em>after</em>. Returns a reference to the string.
	1547	<p> If <em>cs</em> is TRUE (the default), the search is case sensitive;
	1548	otherwise the search is case insensitive.
	1549
	1550	<h3 class=fn><a href="qstring.html">QString</a> & <a name="replace-7"></a>QString::replace ( const <a href="qstring.html">QString</a> & before, const <a href="qstring.html">QString</a> & after, bool cs = TRUE )
	1551	</h3> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	1552	<p> Replaces every occurrence of the string <em>before</em> in the string
	1553	with the string <em>after</em>. Returns a reference to the string.
	1554	<p> If <em>cs</em> is TRUE (the default), the search is case sensitive;
	1555	otherwise the search is case insensitive.
	1556	<p> Example:
	1557	<pre>
	1558	QString s = "Greek is Greek";
	1559	s.<a href="#replace">replace</a>( "Greek", "English" );
	1560	// s == "English is English"
	1561	</pre>
	1562
	1563
	1564	<h3 class=fn><a href="qstring.html">QString</a> & <a name="replace-8"></a>QString::replace ( const <a href="qregexp.html">QRegExp</a> & rx, const <a href="qstring.html">QString</a> & after )
	1565	</h3> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	1566	<p> Replaces every occurrence of the regexp <em>rx</em> in the string with
	1567	<em>after</em>. Returns a reference to the string. For example:
	1568	<pre>
	1569	QString s = "banana";
	1570	s.<a href="#replace">replace</a>( QRegExp("an"), "" );
	1571	// s == "ba"
	1572	</pre>
	1573
	1574	<p> For regexps containing <a href="qregexp.html#capturing-text">capturing
	1575	parentheses</a>, occurrences of <b>\1</b>, <b>\2</b>, ...,
	1576	in <em>after</em> are replaced with <em>rx</em>.cap(1), cap(2), ...
	1577	<p> <pre>
	1578	QString t = "A <i>bon mot</i>.";
	1579	t.<a href="#replace">replace</a>( QRegExp("<i>([^<]*)</i>"), "\\emph{\\1}" );
	1580	// t == "A \\emph{bon mot}."
	1581	</pre>
	1582
	1583	<p> <p>See also <a href="#find">find</a>(), <a href="#findRev">findRev</a>(), and <a href="qregexp.html#cap">QRegExp::cap</a>().
	1584
	1585	<h3 class=fn><a href="qstring.html">QString</a> & <a name="replace-9"></a>QString::replace ( <a href="qchar.html">QChar</a> c1, <a href="qchar.html">QChar</a> c2 )
	1586	</h3> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	1587	<p> Replaces every occurrence of <em>c1</em> with the char <em>c2</em>. Returns a
	1588	reference to the string.
	1589
	1590	<h3 class=fn>void <a name="reserve"></a>QString::reserve ( uint minCapacity )
	1591	</h3>
	1592	Ensures that at least <em>minCapacity</em> characters are allocated to
	1593	the string.
	1594	<p> This function is useful for code that needs to build up a long
	1595	string and wants to avoid repeated reallocation. In this example,
	1596	we want to add to the string until some condition is true, and
	1597	we're fairly sure that size is big enough:
	1598	<pre>
	1599	QString result;
	1600	int len = 0;
	1601	result.<a href="#reserve">reserve</a>(maxLen);
	1602	while (...) {
	1603	result[len++] = ... // fill part of the space
	1604	}
	1605	result.<a href="#squeeze">squeeze</a>();
	1606	</pre>
	1607
	1608	<p> If <em>maxLen</em> is an underestimate, the worst that will happen is
	1609	that the loop will slow down.
	1610	<p> If it is not possible to allocate enough memory, the string
	1611	remains unchanged.
	1612	<p> <p>See also <a href="#capacity">capacity</a>(), <a href="#squeeze">squeeze</a>(), and <a href="#setLength">setLength</a>().
	1613
	1614	<h3 class=fn><a href="qstring.html">QString</a> <a name="right"></a>QString::right ( uint len ) const
	1615	</h3>
	1616	Returns a string that contains the <em>len</em> rightmost characters of
	1617	the string.
	1618	<p> If <em>len</em> is greater than the length of the string then the whole
	1619	string is returned.
	1620	<p> <pre>
	1621	QString string( "Pineapple" );
	1622	QString t = string.<a href="#right">right</a>( 5 ); // t == "apple"
	1623	</pre>
	1624
	1625	<p> <p>See also <a href="#left">left</a>(), <a href="#mid">mid</a>(), and <a href="#isEmpty">isEmpty</a>().
	1626
	1627	<p>Example: <a href="fileiconview-example.html#x871">fileiconview/qfileiconview.cpp</a>.
	1628	<h3 class=fn><a href="qstring.html">QString</a> <a name="rightJustify"></a>QString::rightJustify ( uint width, <a href="qchar.html">QChar</a> fill = ' ', bool truncate = FALSE ) const
	1629	</h3>
	1630	Returns a string of length <em>width</em> that contains the <em>fill</em>
	1631	character followed by the string.
	1632	<p> If <em>truncate</em> is FALSE and the length of the string is more than
	1633	<em>width</em>, then the returned string is a copy of the string.
	1634	<p> If <em>truncate</em> is TRUE and the length of the string is more than
	1635	<em>width</em>, then the resulting string is truncated at position <em>width</em>.
	1636	<p> <pre>
	1637	QString string( "apple" );
	1638	QString t = string.<a href="#rightJustify">rightJustify</a>( 8, '.' ); // t == "...apple"
	1639	</pre>
	1640
	1641	<p> <p>See also <a href="#leftJustify">leftJustify</a>().
	1642
	1643	<h3 class=fn><a href="qstring.html">QString</a> <a name="section"></a>QString::section ( <a href="qchar.html">QChar</a> sep, int start, int end = 0xffffffff, int flags = SectionDefault ) const
	1644	</h3>
	1645
	1646	<p> This function returns a section of the string.
	1647	<p> This string is treated as a sequence of fields separated by the
	1648	character, <em>sep</em>. The returned string consists of the fields from
	1649	position <em>start</em> to position <em>end</em> inclusive. If <em>end</em> is not
	1650	specified, all fields from position <em>start</em> to the end of the
	1651	string are included. Fields are numbered 0, 1, 2, etc., counting
	1652	from the left, and -1, -2, etc., counting from right to left.
	1653	<p> The <em>flags</em> argument can be used to affect some aspects of the
	1654	function's behaviour, e.g. whether to be case sensitive, whether
	1655	to skip empty fields and how to deal with leading and trailing
	1656	separators; see <a href="#SectionFlags-enum">SectionFlags</a>.
	1657	<p> <pre>
	1658	QString csv( "forename,middlename,surname,phone" );
	1659	QString s = csv.<a href="#section">section</a>( ',', 2, 2 ); // s == "surname"
	1660
	1661	QString path( "/usr/local/bin/myapp" ); // First field is empty
	1662	QString s = path.<a href="#section">section</a>( '/', 3, 4 ); // s == "bin/myapp"
	1663	QString s = path.<a href="#section">section</a>( '/', 3, 3, SectionSkipEmpty ); // s == "myapp"
	1664	</pre>
	1665
	1666	<p> If <em>start</em> or <em>end</em> is negative, we count fields from the right
	1667	of the string, the right-most field being -1, the one from
	1668	right-most field being -2, and so on.
	1669	<p> <pre>
	1670	QString csv( "forename,middlename,surname,phone" );
	1671	QString s = csv.<a href="#section">section</a>( ',', -3, -2 ); // s == "middlename,surname"
	1672
	1673	QString path( "/usr/local/bin/myapp" ); // First field is empty
	1674	QString s = path.<a href="#section">section</a>( '/', -1 ); // s == "myapp"
	1675	</pre>
	1676
	1677	<p> <p>See also <a href="qstringlist.html#split">QStringList::split</a>().
	1678
	1679	<p>Examples: <a href="tutorial2-03.html#x2551">chart/element.cpp</a> and <a href="ftpclient-example.html#x772">network/ftpclient/ftpmainwindow.ui.h</a>.
	1680	<h3 class=fn><a href="qstring.html">QString</a> <a name="section-2"></a>QString::section ( char sep, int start, int end = 0xffffffff, int flags = SectionDefault ) const
	1681	</h3>
	1682
	1683	<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	1684	<p>
	1685	<h3 class=fn><a href="qstring.html">QString</a> <a name="section-3"></a>QString::section ( const char * sep, int start, int end = 0xffffffff, int flags = SectionDefault ) const
	1686	</h3>
	1687
	1688	<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	1689	<p>
	1690	<h3 class=fn><a href="qstring.html">QString</a> <a name="section-4"></a>QString::section ( const <a href="qstring.html">QString</a> & sep, int start, int end = 0xffffffff, int flags = SectionDefault ) const
	1691	</h3>
	1692	This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	1693	<p> This function returns a section of the string.
	1694	<p> This string is treated as a sequence of fields separated by the
	1695	string, <em>sep</em>. The returned string consists of the fields from
	1696	position <em>start</em> to position <em>end</em> inclusive. If <em>end</em> is not
	1697	specified, all fields from position <em>start</em> to the end of the
	1698	string are included. Fields are numbered 0, 1, 2, etc., counting
	1699	from the left, and -1, -2, etc., counting from right to left.
	1700	<p> The <em>flags</em> argument can be used to affect some aspects of the
	1701	function's behaviour, e.g. whether to be case sensitive, whether
	1702	to skip empty fields and how to deal with leading and trailing
	1703	separators; see <a href="#SectionFlags-enum">SectionFlags</a>.
	1704	<p> <pre>
	1705	QString data( "forenamemiddlenamesurname**phone" );
	1706	QString s = data.<a href="#section">section</a>( "**", 2, 2 ); // s == "surname"
	1707	</pre>
	1708
	1709	<p> If <em>start</em> or <em>end</em> is negative, we count fields from the right
	1710	of the string, the right-most field being -1, the one from
	1711	right-most field being -2, and so on.
	1712	<p> <pre>
	1713	QString data( "forenamemiddlenamesurname**phone" );
	1714	QString s = data.<a href="#section">section</a>( "", -3, -2 ); // s == "middlenamesurname"
	1715	</pre>
	1716
	1717	<p> <p>See also <a href="qstringlist.html#split">QStringList::split</a>().
	1718
	1719	<h3 class=fn><a href="qstring.html">QString</a> <a name="section-5"></a>QString::section ( const <a href="qregexp.html">QRegExp</a> & reg, int start, int end = 0xffffffff, int flags = SectionDefault ) const
	1720	</h3>
	1721	This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	1722	<p> This function returns a section of the string.
	1723	<p> This string is treated as a sequence of fields separated by the
	1724	<a href="qregexp.html#regular-expression">regular expression</a>, <em>reg</em>. The returned string consists of the
	1725	fields from position <em>start</em> to position <em>end</em> inclusive. If <em>end</em> is not specified, all fields from position <em>start</em> to the end
	1726	of the string are included. Fields are numbered 0, 1, 2, etc., counting
	1727	from the left, and -1, -2, etc., counting from right to left.
	1728	<p> The <em>flags</em> argument can be used to affect some aspects of the
	1729	function's behaviour, e.g. whether to be case sensitive, whether
	1730	to skip empty fields and how to deal with leading and trailing
	1731	separators; see <a href="#SectionFlags-enum">SectionFlags</a>.
	1732	<p> <pre>
	1733	QString line( "forename\tmiddlename surname \t \t phone" );
	1734	<a href="qregexp.html">QRegExp</a> sep( "\s+" );
	1735	QString s = line.<a href="#section">section</a>( sep, 2, 2 ); // s == "surname"
	1736	</pre>
	1737
	1738	<p> If <em>start</em> or <em>end</em> is negative, we count fields from the right
	1739	of the string, the right-most field being -1, the one from
	1740	right-most field being -2, and so on.
	1741	<p> <pre>
	1742	QString line( "forename\tmiddlename surname \t \t phone" );
	1743	<a href="qregexp.html">QRegExp</a> sep( "\\s+" );
	1744	QString s = line.<a href="#section">section</a>( sep, -3, -2 ); // s == "middlename surname"
	1745	</pre>
	1746
	1747	<p> <b>Warning:</b> Using this <a href="qregexp.html">QRegExp</a> version is much more expensive than
	1748	the overloaded string and character versions.
	1749	<p> <p>See also <a href="qstringlist.html#split">QStringList::split</a>() and <a href="#simplifyWhiteSpace">simplifyWhiteSpace</a>().
	1750
	1751	<h3 class=fn><a href="qstring.html">QString</a> & <a name="setAscii"></a>QString::setAscii ( const char * str, int len = -1 )
	1752	</h3>
	1753	Sets this string to <em>str</em>, interpreted as a classic 8-bit ASCII C
	1754	string. If <em>len</em> is -1 (the default), then it is set to
	1755	strlen(str).
	1756	<p> If <em>str</em> is 0 a null string is created. If <em>str</em> is "", an empty
	1757	string is created.
	1758	<p> <p>See also <a href="#isNull">isNull</a>() and <a href="#isEmpty">isEmpty</a>().
	1759
	1760	<h3 class=fn>void <a name="setExpand"></a>QString::setExpand ( uint index, <a href="qchar.html">QChar</a> c )
	1761	</h3> <b>This function is obsolete.</b> It is provided to keep old source working. We strongly advise against using it in new code.
	1762	<p> Sets the character at position <em>index</em> to <em>c</em> and expands the
	1763	string if necessary, filling with spaces.
	1764	<p> This method is redundant in Qt 3.x, because operator[] will expand
	1765	the string as necessary.
	1766
	1767	<h3 class=fn><a href="qstring.html">QString</a> & <a name="setLatin1"></a>QString::setLatin1 ( const char * str, int len = -1 )
	1768	</h3>
	1769	Sets this string to <em>str</em>, interpreted as a classic Latin-1 C
	1770	string. If <em>len</em> is -1 (the default), then it is set to
	1771	strlen(str).
	1772	<p> If <em>str</em> is 0 a null string is created. If <em>str</em> is "", an empty
	1773	string is created.
	1774	<p> <p>See also <a href="#isNull">isNull</a>() and <a href="#isEmpty">isEmpty</a>().
	1775
	1776	<h3 class=fn>void <a name="setLength"></a>QString::setLength ( uint newLen )
	1777	</h3>
	1778	Ensures that at least <em>newLen</em> characters are allocated to the
	1779	string, and sets the length of the string to <em>newLen</em>. Any new
	1780	space allocated contains arbitrary data.
	1781	<p> <p>See also <a href="#reserve">reserve</a>() and <a href="#truncate">truncate</a>().
	1782
	1783	<h3 class=fn><a href="qstring.html">QString</a> & <a name="setNum"></a>QString::setNum ( Q_LLONG n, int base = 10 )
	1784	</h3>
	1785	Sets the string to the printed value of <em>n</em> in base <em>base</em> and
	1786	returns a reference to the string. The returned string is in "C" locale.
	1787	<p> The base is 10 by default and must be between 2 and 36.
	1788	<p> <pre>
	1789	QString string;
	1790	string = string.<a href="#setNum">setNum</a>( 1234 ); // string == "1234"
	1791	</pre>
	1792
	1793
	1794	<h3 class=fn><a href="qstring.html">QString</a> & <a name="setNum-2"></a>QString::setNum ( short n, int base = 10 )
	1795	</h3>
	1796
	1797	<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	1798	<p> Sets the string to the printed value of <em>n</em> in base <em>base</em> and
	1799	returns a reference to the string.
	1800	<p> The base is 10 by default and must be between 2 and 36.
	1801
	1802	<h3 class=fn><a href="qstring.html">QString</a> & <a name="setNum-3"></a>QString::setNum ( ushort n, int base = 10 )
	1803	</h3>
	1804
	1805	<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	1806	<p> Sets the string to the printed value of <em>n</em> in base <em>base</em> and
	1807	returns a reference to the string.
	1808	<p> The base is 10 by default and must be between 2 and 36.
	1809
	1810	<h3 class=fn><a href="qstring.html">QString</a> & <a name="setNum-4"></a>QString::setNum ( int n, int base = 10 )
	1811	</h3>
	1812
	1813	<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	1814	<p> Sets the string to the printed value of <em>n</em> in base <em>base</em> and
	1815	returns a reference to the string.
	1816	<p> The base is 10 by default and must be between 2 and 36.
	1817
	1818	<h3 class=fn><a href="qstring.html">QString</a> & <a name="setNum-5"></a>QString::setNum ( uint n, int base = 10 )
	1819	</h3>
	1820
	1821	<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	1822	<p> Sets the string to the printed value of <em>n</em> in base <em>base</em> and
	1823	returns a reference to the string.
	1824	<p> The base is 10 by default and must be between 2 and 36.
	1825
	1826	<h3 class=fn><a href="qstring.html">QString</a> & <a name="setNum-6"></a>QString::setNum ( long n, int base = 10 )
	1827	</h3>
	1828
	1829	<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	1830	<p>
	1831	<h3 class=fn><a href="qstring.html">QString</a> & <a name="setNum-7"></a>QString::setNum ( ulong n, int base = 10 )
	1832	</h3>
	1833
	1834	<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	1835	<p>
	1836	<h3 class=fn><a href="qstring.html">QString</a> & <a name="setNum-8"></a>QString::setNum ( Q_ULLONG n, int base = 10 )
	1837	</h3>
	1838	This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	1839	<p> Sets the string to the printed value of <em>n</em> in base <em>base</em> and
	1840	returns a reference to the string.
	1841	<p> The base is 10 by default and must be between 2 and 36.
	1842
	1843	<h3 class=fn><a href="qstring.html">QString</a> & <a name="setNum-9"></a>QString::setNum ( float n, char f = 'g', int prec = 6 )
	1844	</h3>
	1845
	1846	<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	1847	<p> Sets the string to the printed value of <em>n</em>, formatted in format
	1848	<em>f</em> with precision <em>prec</em>, and returns a reference to the
	1849	string.
	1850	<p> The format <em>f</em> can be 'f', 'F', 'e', 'E', 'g' or 'G'. See <a href="#arg-formats">arg</a>() for an explanation of the formats.
	1851
	1852	<h3 class=fn><a href="qstring.html">QString</a> & <a name="setNum-a"></a>QString::setNum ( double n, char f = 'g', int prec = 6 )
	1853	</h3>
	1854	This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	1855	<p> Sets the string to the printed value of <em>n</em>, formatted in format
	1856	<em>f</em> with precision <em>prec</em>, and returns a reference to the
	1857	string.
	1858	<p> The format <em>f</em> can be 'f', 'F', 'e', 'E', 'g' or 'G'. See <a href="#arg-formats">arg</a>() for an explanation of the formats.
	1859
	1860	<h3 class=fn><a href="qstring.html">QString</a> & <a name="setUnicode"></a>QString::setUnicode ( const <a href="qchar.html">QChar</a> * unicode, uint len )
	1861	</h3>
	1862	Resizes the string to <em>len</em> characters and copies <em>unicode</em> into
	1863	the string. If <em>unicode</em> is 0, nothing is copied, but the
	1864	string is still resized to <em>len</em>. If <em>len</em> is zero, then the
	1865	string becomes a <a href="#isNull">null</a> string.
	1866	<p> <p>See also <a href="#setLatin1">setLatin1</a>() and <a href="#isNull">isNull</a>().
	1867
	1868	<h3 class=fn><a href="qstring.html">QString</a> & <a name="setUnicodeCodes"></a>QString::setUnicodeCodes ( const ushort * unicode_as_ushorts, uint len )
	1869	</h3>
	1870	Resizes the string to <em>len</em> characters and copies <em>unicode_as_ushorts</em> into the string (on some X11 client platforms
	1871	this will involve a byte-swapping pass).
	1872	<p> If <em>unicode_as_ushorts</em> is 0, nothing is copied, but the string
	1873	is still resized to <em>len</em>. If <em>len</em> is zero, the string becomes
	1874	a <a href="#isNull">null</a> string.
	1875	<p> <p>See also <a href="#setLatin1">setLatin1</a>() and <a href="#isNull">isNull</a>().
	1876
	1877	<h3 class=fn><a href="qstring.html">QString</a> <a name="simplifyWhiteSpace"></a>QString::simplifyWhiteSpace () const
	1878	</h3>
	1879	Returns a string that has whitespace removed from the start and
	1880	the end, and which has each sequence of internal whitespace
	1881	replaced with a single space.
	1882	<p> Whitespace means any character for which <a href="qchar.html#isSpace">QChar::isSpace</a>() returns
	1883	TRUE. This includes Unicode characters with decimal values 9
	1884	(TAB), 10 (LF), 11 (VT), 12 (FF), 13 (CR), and 32 (Space).
	1885	<p> <pre>
	1886	QString string = " lots\t of\nwhite space ";
	1887	QString t = string.<a href="#simplifyWhiteSpace">simplifyWhiteSpace</a>();
	1888	// t == "lots of white space"
	1889	</pre>
	1890
	1891	<p> <p>See also <a href="#stripWhiteSpace">stripWhiteSpace</a>().
	1892
	1893	<h3 class=fn><a href="qstring.html">QString</a> & <a name="sprintf"></a>QString::sprintf ( const char * cformat, ... )
	1894	</h3>
	1895	Safely builds a formatted string from the format string <em>cformat</em>
	1896	and an arbitrary list of arguments. The format string supports all
	1897	the escape sequences of printf() in the standard C library.
	1898	<p> The %s escape sequence expects a <a href="#utf8">utf8</a>() encoded string. The format
	1899	string <em>cformat</em> is expected to be in latin1. If you need a
	1900	Unicode format string, use <a href="#arg">arg</a>() instead. For typesafe string
	1901	building, with full Unicode support, you can use <a href="qtextostream.html">QTextOStream</a> like
	1902	this:
	1903	<p> <pre>
	1904	QString str;
	1905	QString s = ...;
	1906	int x = ...;
	1907	QTextOStream( &str ) << s << " : " << x;
	1908	</pre>
	1909
	1910	<p> For <a href="qobject.html#tr">translations,</a> especially if the
	1911	strings contains more than one escape sequence, you should
	1912	consider using the arg() function instead. This allows the order
	1913	of the replacements to be controlled by the translator, and has
	1914	Unicode support.
	1915	<p> The %lc escape sequence expects a unicode character of type ushort
	1916	(as returned by <a href="qchar.html#unicode">QChar::unicode</a>()).
	1917	The %ls escape sequence expects a pointer to a zero-terminated
	1918	array of unicode characters of type ushort (as returned by
	1919	<a href="#ucs2">QString::ucs2</a>()).
	1920	<p> <p>See also <a href="#arg">arg</a>().
	1921
	1922	<p>Examples: <a href="dclock-example.html#x1103">dclock/dclock.cpp</a>, <a href="forever-example.html#x1052">forever/forever.cpp</a>, <a href="layout-example.html#x542">layout/layout.cpp</a>, <a href="qmag-example.html#x1795">qmag/qmag.cpp</a>, <a href="scrollview-example.html#x656">scrollview/scrollview.cpp</a>, <a href="tooltip-example.html#x449">tooltip/tooltip.cpp</a>, and <a href="xform-example.html#x1265">xform/xform.cpp</a>.
	1923	<h3 class=fn>void <a name="squeeze"></a>QString::squeeze ()
	1924	</h3>
	1925	Squeezes the string's capacity to the current content.
	1926	<p> <p>See also <a href="#capacity">capacity</a>() and <a href="#reserve">reserve</a>().
	1927
	1928	<h3 class=fn>bool <a name="startsWith"></a>QString::startsWith ( const <a href="qstring.html">QString</a> & s, bool cs = TRUE ) const
	1929	</h3>
	1930	Returns TRUE if the string starts with <em>s</em>; otherwise returns
	1931	FALSE.
	1932	<p> If <em>cs</em> is TRUE (the default), the search is case sensitive;
	1933	otherwise the search is case insensitive.
	1934	<p> <pre>
	1935	QString str( "Bananas" );
	1936	str.<a href="#startsWith">startsWith</a>( "Ban" ); // returns TRUE
	1937	str.<a href="#startsWith">startsWith</a>( "Car" ); // returns FALSE
	1938	</pre>
	1939
	1940	<p> <p>See also <a href="#endsWith">endsWith</a>().
	1941
	1942	<h3 class=fn><a href="qstring.html">QString</a> <a name="stripWhiteSpace"></a>QString::stripWhiteSpace () const
	1943	</h3>
	1944	Returns a string that has whitespace removed from the start and
	1945	the end.
	1946	<p> Whitespace means any character for which <a href="qchar.html#isSpace">QChar::isSpace</a>() returns
	1947	TRUE. This includes Unicode characters with decimal values 9
	1948	(TAB), 10 (LF), 11 (VT), 12 (FF), 13 (CR) and 32 (Space), and may
	1949	also include other Unicode characters.
	1950	<p> <pre>
	1951	QString string = " white space ";
	1952	QString s = string.<a href="#stripWhiteSpace">stripWhiteSpace</a>(); // s == "white space"
	1953	</pre>
	1954
	1955	<p> <p>See also <a href="#simplifyWhiteSpace">simplifyWhiteSpace</a>().
	1956
	1957	<h3 class=fn>double <a name="toDouble"></a>QString::toDouble ( bool * ok = 0 ) const
	1958	</h3>
	1959	Returns the string converted to a <tt>double</tt> value.
	1960	<p> If <em>ok</em> is not 0: if a conversion error occurs, <em>*ok</em> is set to
	1961	FALSE; otherwise <em>*ok</em> is set to TRUE.
	1962	<p> <pre>
	1963	QString string( "1234.56" );
	1964	double a = string.<a href="#toDouble">toDouble</a>(); // a == 1234.56
	1965	</pre>
	1966
	1967	<p> The string-to-number functions:
	1968	<ul>
	1969	<li> <a href="#toShort">toShort</a>()
	1970	<li> <a href="#toUShort">toUShort</a>()
	1971	<li> <a href="#toInt">toInt</a>()
	1972	<li> <a href="#toUInt">toUInt</a>()
	1973	<li> <a href="#toLong">toLong</a>()
	1974	<li> <a href="#toULong">toULong</a>()
	1975	<li> <a href="#toLongLong">toLongLong</a>()
	1976	<li> <a href="#toULongLong">toULongLong</a>()
	1977	<li> <a href="#toFloat">toFloat</a>()
	1978	<li> <a href="#toDouble">toDouble</a>()
	1979	</ul>
	1980	can handle numbers
	1981	represented in various locales. These representations may use different
	1982	characters for the decimal point, thousands group sepearator
	1983	and even individual digits. QString's functions try to interpret
	1984	the string according to the current locale. The current locale is
	1985	determined from the system at application startup and can be changed
	1986	by calling <a href="qlocale.html#setDefault">QLocale::setDefault</a>(). If the string cannot be interpreted
	1987	according to the current locale, this function falls back
	1988	on the "C" locale.
	1989	<p> <pre>
	1990	bool ok;
	1991	double d;
	1992
	1993	QLocale::<a href="qlocale.html#setDefault">setDefault</a>(QLocale::C);
	1994	d = <a href="#QString">QString</a>( "1234,56" ).toDouble(&ok); // ok == false
	1995	d = <a href="#QString">QString</a>( "1234.56" ).toDouble(&ok); // ok == true, d == 1234.56
	1996
	1997	QLocale::<a href="qlocale.html#setDefault">setDefault</a>(QLocale::German);
	1998	d = <a href="#QString">QString</a>( "1234,56" ).toDouble(&ok); // ok == true, d == 1234.56
	1999	d = <a href="#QString">QString</a>( "1234.56" ).toDouble(&ok); // ok == true, d == 1234.56
	2000	</pre>
	2001
	2002	<p> Due to the ambiguity between the decimal point and thousands group
	2003	separator in various locales, these functions do not handle
	2004	thousands group separators. If you need to convert such numbers,
	2005	use the corresponding function in <a href="qlocale.html">QLocale</a>.
	2006	<p> <pre>
	2007	bool ok;
	2008	QLocale::<a href="qlocale.html#setDefault">setDefault</a>(QLocale::C);
	2009	double d = <a href="#QString">QString</a>( "1,234,567.89" ).toDouble(&ok); // ok == false
	2010	</pre>
	2011
	2012	<p> <b>Warning:</b> If the string contains trailing whitespace this function
	2013	will fail, and set <em>*ok</em> to false if <em>ok</em> is not 0. Leading
	2014	whitespace is ignored.
	2015	<p> <p>See also <a href="#number">number</a>(), <a href="qlocale.html#setDefault">QLocale::setDefault</a>(), <a href="qlocale.html#toDouble">QLocale::toDouble</a>(), and <a href="#stripWhiteSpace">stripWhiteSpace</a>().
	2016
	2017	<h3 class=fn>float <a name="toFloat"></a>QString::toFloat ( bool * ok = 0 ) const
	2018	</h3>
	2019	Returns the string converted to a <tt>float</tt> value.
	2020	<p> Returns 0.0 if the conversion fails.
	2021	<p> If <em>ok</em> is not 0: if a conversion error occurs, <em>*ok</em> is set to
	2022	FALSE; otherwise <em>*ok</em> is set to TRUE.
	2023	<p> For information on how string-to-number functions in QString handle
	2024	localized input, see <a href="#toDouble">toDouble</a>().
	2025	<p> <b>Warning:</b> If the string contains trailing whitespace this function
	2026	will fail, settings <em>*ok</em> to false if <em>ok</em> is not 0.
	2027	Leading whitespace is ignored.
	2028	<p> <p>See also <a href="#number">number</a>().
	2029
	2030	<h3 class=fn>int <a name="toInt"></a>QString::toInt ( bool * ok = 0, int base = 10 ) const
	2031	</h3>
	2032	Returns the string converted to an <tt>int</tt> using base <em>base</em>, which is 10 by default and must be between 2 and 36 or 0. If
	2033	<em>base</em> is 0, the base is determined automatically using the
	2034	following rules:
	2035	<ul>
	2036	<li>If the string begins with "0x", it is assumed to
	2037	be hexadecimal;
	2038	<li>If it begins with "0", it is assumed to be octal;
	2039	<li>Otherwise it is assumed to be decimal.
	2040	</ul>
	2041	<p> Returns 0 if the conversion fails.
	2042	<p> If <em>ok</em> is not 0: if a conversion error occurs, <em>*ok</em> is set to
	2043	FALSE; otherwise <em>*ok</em> is set to TRUE.
	2044	<p> <pre>
	2045	QString str( "FF" );
	2046	bool ok;
	2047	int hex = str.<a href="#toInt">toInt</a>( &ok, 16 ); // hex == 255, ok == TRUE
	2048	int dec = str.<a href="#toInt">toInt</a>( &ok, 10 ); // dec == 0, ok == FALSE
	2049	</pre>
	2050
	2051	<p> Leading and trailing whitespace is ignored by this function.
	2052	<p> For information on how string-to-number functions in QString handle
	2053	localized input, see <a href="#toDouble">toDouble</a>().
	2054	<p> <p>See also <a href="#number">number</a>().
	2055
	2056	<h3 class=fn>long <a name="toLong"></a>QString::toLong ( bool * ok = 0, int base = 10 ) const
	2057	</h3>
	2058	Returns the string converted to a <tt>long</tt> using base <em>base</em>, which is 10 by default and must be between 2 and 36 or 0. If
	2059	<em>base</em> is 0, the base is determined automatically using the
	2060	following rules:
	2061	<ul>
	2062	<li>If the string begins with "0x", it is assumed to
	2063	be hexadecimal;
	2064	<li>If it begins with "0", it is assumed to be octal;
	2065	<li>Otherwise it is assumed to be decimal.
	2066	</ul>
	2067	<p> Returns 0 if the conversion fails.
	2068	<p> If <em>ok</em> is not 0: if a conversion error occurs, <em>*ok</em> is set to
	2069	FALSE; otherwise <em>*ok</em> is set to TRUE.
	2070	<p> Leading and trailing whitespace is ignored by this function.
	2071	<p> For information on how string-to-number functions in QString handle
	2072	localized input, see <a href="#toDouble">toDouble</a>().
	2073	<p> <p>See also <a href="#number">number</a>().
	2074
	2075	<h3 class=fn>Q_LLONG <a name="toLongLong"></a>QString::toLongLong ( bool * ok = 0, int base = 10 ) const
	2076	</h3>
	2077	Returns the string converted to a <tt>long long</tt> using base <em>base</em>, which is 10 by default and must be between 2 and 36 or 0. If
	2078	<em>base</em> is 0, the base is determined automatically using the
	2079	following rules:
	2080	<ul>
	2081	<li>If the string begins with "0x", it is assumed to
	2082	be hexadecimal;
	2083	<li>If it begins with "0", it is assumed to be octal;
	2084	<li>Otherwise it is assumed to be decimal.
	2085	</ul>
	2086	<p> Returns 0 if the conversion fails.
	2087	<p> If <em>ok</em> is not 0: if a conversion error occurs, <em>*ok</em> is set to
	2088	FALSE; otherwise <em>*ok</em> is set to TRUE.
	2089	<p> Leading and trailing whitespace is ignored by this function.
	2090	<p> For information on how string-to-number functions in QString handle
	2091	localized input, see <a href="#toDouble">toDouble</a>().
	2092	<p> <p>See also <a href="#number">number</a>().
	2093
	2094	<h3 class=fn>short <a name="toShort"></a>QString::toShort ( bool * ok = 0, int base = 10 ) const
	2095	</h3>
	2096	Returns the string converted to a <tt>short</tt> using base <em>base</em>, which is 10 by default and must be between 2 and 36 or 0. If
	2097	<em>base</em> is 0, the base is determined automatically using the
	2098	following rules:
	2099	<ul>
	2100	<li>If the string begins with "0x", it is assumed to
	2101	be hexadecimal;
	2102	<li>If it begins with "0", it is assumed to be octal;
	2103	<li>Otherwise it is assumed to be decimal.
	2104	</ul>
	2105	<p> Returns 0 if the conversion fails.
	2106	<p> If <em>ok</em> is not 0: if a conversion error occurs, <em>*ok</em> is set to
	2107	FALSE; otherwise <em>*ok</em> is set to TRUE.
	2108	<p> Leading and trailing whitespace is ignored by this function.
	2109	<p> For information on how string-to-number functions in QString handle
	2110	localized input, see <a href="#toDouble">toDouble</a>().
	2111	<p> <p>See also <a href="#number">number</a>().
	2112
	2113	<h3 class=fn>uint <a name="toUInt"></a>QString::toUInt ( bool * ok = 0, int base = 10 ) const
	2114	</h3>
	2115	Returns the string converted to an <tt>unsigned int</tt> using base <em>base</em>, which is 10 by default and must be between 2 and 36 or 0. If
	2116	<em>base</em> is 0, the base is determined automatically using the
	2117	following rules:
	2118	<ul>
	2119	<li>If the string begins with "0x", it is assumed to
	2120	be hexadecimal;
	2121	<li>If it begins with "0", it is assumed to be octal;
	2122	<li>Otherwise it is assumed to be decimal.
	2123	</ul>
	2124	<p> Returns 0 if the conversion fails.
	2125	<p> If <em>ok</em> is not 0: if a conversion error occurs, <em>*ok</em> is set to
	2126	FALSE; otherwise <em>*ok</em> is set to TRUE.
	2127	<p> Leading and trailing whitespace is ignored by this function.
	2128	<p> For information on how string-to-number functions in QString handle
	2129	localized input, see <a href="#toDouble">toDouble</a>().
	2130	<p> <p>See also <a href="#number">number</a>().
	2131
	2132	<h3 class=fn>ulong <a name="toULong"></a>QString::toULong ( bool * ok = 0, int base = 10 ) const
	2133	</h3>
	2134	Returns the string converted to an <tt>unsigned long</tt> using base <em>base</em>, which is 10 by default and must be between 2 and 36 or 0. If
	2135	<em>base</em> is 0, the base is determined automatically using the
	2136	following rules:
	2137	<ul>
	2138	<li>If the string begins with "0x", it is assumed to
	2139	be hexadecimal;
	2140	<li>If it begins with "0", it is assumed to be octal;
	2141	<li>Otherwise it is assumed to be decimal.
	2142	</ul>
	2143	<p> Returns 0 if the conversion fails.
	2144	<p> If <em>ok</em> is not 0: if a conversion error occurs, <em>*ok</em> is set to
	2145	FALSE; otherwise <em>*ok</em> is set to TRUE.
	2146	<p> Leading and trailing whitespace is ignored by this function.
	2147	<p> For information on how string-to-number functions in QString handle
	2148	localized input, see <a href="#toDouble">toDouble</a>().
	2149	<p> <p>See also <a href="#number">number</a>().
	2150
	2151	<h3 class=fn>Q_ULLONG <a name="toULongLong"></a>QString::toULongLong ( bool * ok = 0, int base = 10 ) const
	2152	</h3>
	2153	Returns the string converted to an <tt>unsigned long long</tt> using base <em>base</em>, which is 10 by default and must be between 2 and 36 or 0. If
	2154	<em>base</em> is 0, the base is determined automatically using the
	2155	following rules:
	2156	<ul>
	2157	<li>If the string begins with "0x", it is assumed to
	2158	be hexadecimal;
	2159	<li>If it begins with "0", it is assumed to be octal;
	2160	<li>Otherwise it is assumed to be decimal.
	2161	</ul>
	2162	<p> Returns 0 if the conversion fails.
	2163	<p> If <em>ok</em> is not 0: if a conversion error occurs, <em>*ok</em> is set to
	2164	FALSE; otherwise <em>*ok</em> is set to TRUE.
	2165	<p> Leading and trailing whitespace is ignored by this function.
	2166	<p> For information on how string-to-number functions in QString handle
	2167	localized input, see <a href="#toDouble">toDouble</a>().
	2168	<p> <p>See also <a href="#number">number</a>().
	2169
	2170	<h3 class=fn>ushort <a name="toUShort"></a>QString::toUShort ( bool * ok = 0, int base = 10 ) const
	2171	</h3>
	2172	Returns the string converted to an <tt>unsigned short</tt> using base <em>base</em>, which is 10 by default and must be between 2 and 36 or 0. If
	2173	<em>base</em> is 0, the base is determined automatically using the
	2174	following rules:
	2175	<ul>
	2176	<li>If the string begins with "0x", it is assumed to
	2177	be hexadecimal;
	2178	<li>If it begins with "0", it is assumed to be octal;
	2179	<li>Otherwise it is assumed to be decimal.
	2180	</ul>
	2181	<p> Returns 0 if the conversion fails.
	2182	<p> If <em>ok</em> is not 0: if a conversion error occurs, <em>*ok</em> is set to
	2183	FALSE; otherwise <em>*ok</em> is set to TRUE.
	2184	<p> Leading and trailing whitespace is ignored by this function.
	2185	<p> For information on how string-to-number functions in QString handle
	2186	localized input, see <a href="#toDouble">toDouble</a>().
	2187	<p> <p>See also <a href="#number">number</a>().
	2188
	2189	<h3 class=fn>void <a name="truncate"></a>QString::truncate ( uint newLen )
	2190	</h3>
	2191	If <em>newLen</em> is less than the length of the string, then the
	2192	string is truncated at position <em>newLen</em>. Otherwise nothing
	2193	happens.
	2194	<p> <pre>
	2195	QString s = "truncate me";
	2196	s.<a href="#truncate">truncate</a>( 5 ); // s == "trunc"
	2197	</pre>
	2198
	2199	<p> <p>See also <a href="#setLength">setLength</a>().
	2200
	2201	<p>Example: <a href="mail-example.html#x718">network/mail/smtp.cpp</a>.
	2202	<h3 class=fn>const unsigned short * <a name="ucs2"></a>QString::ucs2 () const
	2203	</h3>
	2204	Returns the QString as a zero terminated array of unsigned shorts
	2205	if the string is not null; otherwise returns zero.
	2206	<p> The result remains valid so long as one unmodified
	2207	copy of the source string exists.
	2208
	2209	<p>Example: <a href="activeqt-dotnet.html#x2467">dotnet/wrapper/lib/tools.cpp</a>.
	2210	<h3 class=fn>const <a href="qchar.html">QChar</a> * <a name="unicode"></a>QString::unicode () const
	2211	</h3>
	2212
	2213	<p> Returns the Unicode representation of the string. The result
	2214	remains valid until the string is modified.
	2215
	2216	<h3 class=fn><a href="qstring.html">QString</a> <a name="upper"></a>QString::upper () const
	2217	</h3>
	2218	Returns an uppercase copy of the string.
	2219	<p> <pre>
	2220	QString string( "TeXt" );
	2221	str = string.<a href="#upper">upper</a>(); // t == "TEXT"
	2222	</pre>
	2223
	2224	<p> <p>See also <a href="#lower">lower</a>().
	2225
	2226	<p>Examples: <a href="scribble-example.html#x942">scribble/scribble.cpp</a> and <a href="sql.html#x2240">sql/overview/custom1/main.cpp</a>.
	2227	<h3 class=fn><a href="qcstring.html">QCString</a> <a name="utf8"></a>QString::utf8 () const
	2228	</h3>
	2229	Returns the string encoded in UTF-8 format.
	2230	<p> See <a href="qtextcodec.html">QTextCodec</a> for more diverse coding/decoding of Unicode strings.
	2231	<p> <p>See also <a href="#fromUtf8">fromUtf8</a>(), <a href="#ascii">ascii</a>(), <a href="#latin1">latin1</a>(), and <a href="#local8Bit">local8Bit</a>().
	2232
	2233	<p>Example: <a href="archivesearch-example.html#x483">network/archivesearch/archivedialog.ui.h</a>.
	2234	<hr><h2>Related Functions</h2>
	2235	<h3 class=fn>bool <a name="operator!-eq"></a>operator!= ( const <a href="qstring.html">QString</a> & s1, const <a href="qstring.html">QString</a> & s2 )
	2236	</h3>
	2237
	2238	<p>
	2239	<p> Returns TRUE if <em>s1</em> is not equal to <em>s2</em>; otherwise returns FALSE.
	2240	Note that a null string is not equal to a not-null empty string.
	2241	<p> Equivalent to <a href="#compare">compare</a>(<em>s1</em>, <em>s2</em>) != 0.
	2242	<p> <p>See also <a href="#isNull">isNull</a>() and <a href="#isEmpty">isEmpty</a>().
	2243
	2244	<h3 class=fn>bool <a name="operator!-eq-2"></a>operator!= ( const <a href="qstring.html">QString</a> & s1, const char * s2 )
	2245	</h3>
	2246
	2247	<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	2248	<p>
	2249	<p> Returns TRUE if <em>s1</em> is not equal to <em>s2</em>; otherwise returns FALSE.
	2250	Note that a null string is not equal to a not-null empty string.
	2251	<p> Equivalent to <a href="#compare">compare</a>(<em>s1</em>, <em>s2</em>) != 0.
	2252	<p> <p>See also <a href="#isNull">isNull</a>() and <a href="#isEmpty">isEmpty</a>().
	2253
	2254	<h3 class=fn>bool <a name="operator!-eq-3"></a>operator!= ( const char * s1, const <a href="qstring.html">QString</a> & s2 )
	2255	</h3>
	2256
	2257	<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	2258	<p>
	2259	<p> Returns TRUE if <em>s1</em> is not equal to <em>s2</em>; otherwise returns FALSE.
	2260	Note that a null string is not equal to a not-null empty string.
	2261	<p> Equivalent to <a href="#compare">compare</a>(<em>s1</em>, <em>s2</em>) != 0.
	2262	<p> <p>See also <a href="#isNull">isNull</a>() and <a href="#isEmpty">isEmpty</a>().
	2263
	2264	<h3 class=fn>const <a href="qstring.html">QString</a> <a name="operator+"></a>operator+ ( const <a href="qstring.html">QString</a> & s1, const <a href="qstring.html">QString</a> & s2 )
	2265	</h3>
	2266
	2267	<p>
	2268	<p> Returns a string which is the result of concatenating the string
	2269	<em>s1</em> and the string <em>s2</em>.
	2270	<p> Equivalent to <em>s1</em>.<a href="#append">append</a>(<em>s2</em>).
	2271
	2272	<h3 class=fn>const <a href="qstring.html">QString</a> <a name="operator+-2"></a>operator+ ( const <a href="qstring.html">QString</a> & s1, const char * s2 )
	2273	</h3>
	2274
	2275	<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	2276	<p>
	2277	<p> Returns a string which is the result of concatenating the string
	2278	<em>s1</em> and character <em>s2</em>.
	2279	<p> Equivalent to <em>s1</em>.<a href="#append">append</a>(<em>s2</em>).
	2280
	2281	<h3 class=fn>const <a href="qstring.html">QString</a> <a name="operator+-3"></a>operator+ ( const char * s1, const <a href="qstring.html">QString</a> & s2 )
	2282	</h3>
	2283
	2284	<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	2285	<p>
	2286	<p> Returns a string which is the result of concatenating the
	2287	character <em>s1</em> and string <em>s2</em>.
	2288
	2289	<h3 class=fn>const <a href="qstring.html">QString</a> <a name="operator+-4"></a>operator+ ( const <a href="qstring.html">QString</a> & s, char c )
	2290	</h3>
	2291
	2292	<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	2293	<p>
	2294	<p> Returns a string which is the result of concatenating the string
	2295	<em>s</em> and character <em>c</em>.
	2296	<p> Equivalent to <em>s</em>.<a href="#append">append</a>(<em>c</em>).
	2297
	2298	<h3 class=fn>const <a href="qstring.html">QString</a> <a name="operator+-5"></a>operator+ ( char c, const <a href="qstring.html">QString</a> & s )
	2299	</h3>
	2300
	2301	<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	2302	<p>
	2303	<p> Returns a string which is the result of concatenating the
	2304	character <em>c</em> and string <em>s</em>.
	2305	<p> Equivalent to <em>s</em>.<a href="#prepend">prepend</a>(<em>c</em>).
	2306
	2307	<h3 class=fn>bool <a name="operator-lt"></a>operator< ( const <a href="qstring.html">QString</a> & s1, const char * s2 )
	2308	</h3>
	2309
	2310	<p>
	2311	<p> Returns TRUE if <em>s1</em> is lexically less than <em>s2</em>; otherwise returns FALSE.
	2312	The comparison is case sensitive.
	2313	<p> Equivalent to <a href="#compare">compare</a>(<em>s1</em>, <em>s2</em>) < 0.
	2314
	2315	<h3 class=fn>bool <a name="operator-lt-2"></a>operator< ( const char * s1, const <a href="qstring.html">QString</a> & s2 )
	2316	</h3>
	2317
	2318	<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	2319	<p>
	2320	<p> Returns TRUE if <em>s1</em> is lexically less than <em>s2</em>; otherwise returns FALSE.
	2321	The comparison is case sensitive.
	2322	<p> Equivalent to <a href="#compare">compare</a>(<em>s1</em>, <em>s2</em>) < 0.
	2323
	2324	<h3 class=fn><a href="qdatastream.html">QDataStream</a> & <a name="operator-lt-lt"></a>operator<< ( <a href="qdatastream.html">QDataStream</a> & s, const <a href="qstring.html">QString</a> & str )
	2325	</h3>
	2326
	2327	<p> Writes the string <em>str</em> to the stream <em>s</em>.
	2328	<p> See also <a href="datastreamformat.html">Format of the QDataStream operators</a>
	2329
	2330	<h3 class=fn>bool <a name="operator-lt-eq"></a>operator<= ( const <a href="qstring.html">QString</a> & s1, const char * s2 )
	2331	</h3>
	2332
	2333	<p>
	2334	<p> Returns TRUE if <em>s1</em> is lexically less than or equal to <em>s2</em>;
	2335	otherwise returns FALSE.
	2336	The comparison is case sensitive.
	2337	Note that a null string is not equal to a not-null empty string.
	2338	<p> Equivalent to <a href="#compare">compare</a>(<em>s1</em>,<em>s2</em>) <= 0.
	2339	<p> <p>See also <a href="#isNull">isNull</a>() and <a href="#isEmpty">isEmpty</a>().
	2340
	2341	<h3 class=fn>bool <a name="operator-lt-eq-2"></a>operator<= ( const char * s1, const <a href="qstring.html">QString</a> & s2 )
	2342	</h3>
	2343
	2344	<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	2345	<p>
	2346	<p> Returns TRUE if <em>s1</em> is lexically less than or equal to <em>s2</em>;
	2347	otherwise returns FALSE.
	2348	The comparison is case sensitive.
	2349	Note that a null string is not equal to a not-null empty string.
	2350	<p> Equivalent to <a href="#compare">compare</a>(<em>s1</em>, <em>s2</em>) <= 0.
	2351	<p> <p>See also <a href="#isNull">isNull</a>() and <a href="#isEmpty">isEmpty</a>().
	2352
	2353	<h3 class=fn>bool <a name="operator-eq-eq"></a>operator== ( const <a href="qstring.html">QString</a> & s1, const <a href="qstring.html">QString</a> & s2 )
	2354	</h3>
	2355
	2356	<p>
	2357	<p> Returns TRUE if <em>s1</em> is equal to <em>s2</em>; otherwise returns FALSE.
	2358	Note that a null string is not equal to a not-null empty string.
	2359	<p> Equivalent to <a href="#compare">compare</a>(<em>s1</em>, <em>s2</em>) == 0.
	2360	<p> <p>See also <a href="#isNull">isNull</a>() and <a href="#isEmpty">isEmpty</a>().
	2361
	2362	<h3 class=fn>bool <a name="operator-eq-eq-2"></a>operator== ( const <a href="qstring.html">QString</a> & s1, const char * s2 )
	2363	</h3>
	2364
	2365	<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	2366	<p>
	2367	<p> Returns TRUE if <em>s1</em> is equal to <em>s2</em>; otherwise returns FALSE.
	2368	Note that a null string is not equal to a not-null empty string.
	2369	<p> Equivalent to <a href="#compare">compare</a>(<em>s1</em>, <em>s2</em>) == 0.
	2370	<p> <p>See also <a href="#isNull">isNull</a>() and <a href="#isEmpty">isEmpty</a>().
	2371
	2372	<h3 class=fn>bool <a name="operator-eq-eq-3"></a>operator== ( const char * s1, const <a href="qstring.html">QString</a> & s2 )
	2373	</h3>
	2374
	2375	<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	2376	<p>
	2377	<p> Returns TRUE if <em>s1</em> is equal to <em>s2</em>; otherwise returns FALSE.
	2378	Note that a null string is not equal to a not-null empty string.
	2379	<p> Equivalent to <a href="#compare">compare</a>(<em>s1</em>, <em>s2</em>) == 0.
	2380	<p> <p>See also <a href="#isNull">isNull</a>() and <a href="#isEmpty">isEmpty</a>().
	2381
	2382	<h3 class=fn>bool <a name="operator-gt"></a>operator> ( const <a href="qstring.html">QString</a> & s1, const char * s2 )
	2383	</h3>
	2384
	2385	<p>
	2386	<p> Returns TRUE if <em>s1</em> is lexically greater than <em>s2</em>; otherwise
	2387	returns FALSE.
	2388	The comparison is case sensitive.
	2389	<p> Equivalent to <a href="#compare">compare</a>(<em>s1</em>, <em>s2</em>) > 0.
	2390
	2391	<h3 class=fn>bool <a name="operator-gt-2"></a>operator> ( const char * s1, const <a href="qstring.html">QString</a> & s2 )
	2392	</h3>
	2393
	2394	<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	2395	<p>
	2396	<p> Returns TRUE if <em>s1</em> is lexically greater than <em>s2</em>; otherwise
	2397	returns FALSE.
	2398	The comparison is case sensitive.
	2399	<p> Equivalent to <a href="#compare">compare</a>(<em>s1</em>, <em>s2</em>) > 0.
	2400
	2401	<h3 class=fn>bool <a name="operator-gt-eq"></a>operator>= ( const <a href="qstring.html">QString</a> & s1, const char * s2 )
	2402	</h3>
	2403
	2404	<p>
	2405	<p> Returns TRUE if <em>s1</em> is lexically greater than or equal to <em>s2</em>;
	2406	otherwise returns FALSE.
	2407	The comparison is case sensitive.
	2408	Note that a null string is not equal to a not-null empty string.
	2409	<p> Equivalent to <a href="#compare">compare</a>(<em>s1</em>, <em>s2</em>) >= 0.
	2410	<p> <p>See also <a href="#isNull">isNull</a>() and <a href="#isEmpty">isEmpty</a>().
	2411
	2412	<h3 class=fn>bool <a name="operator-gt-eq-2"></a>operator>= ( const char * s1, const <a href="qstring.html">QString</a> & s2 )
	2413	</h3>
	2414
	2415	<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
	2416	<p>
	2417	<p> Returns TRUE if <em>s1</em> is lexically greater than or equal to <em>s2</em>;
	2418	otherwise returns FALSE.
	2419	The comparison is case sensitive.
	2420	Note that a null string is not equal to a not-null empty string.
	2421	<p> Equivalent to <a href="#compare">compare</a>(<em>s1</em>, <em>s2</em>) >= 0.
	2422	<p> <p>See also <a href="#isNull">isNull</a>() and <a href="#isEmpty">isEmpty</a>().
	2423
	2424	<h3 class=fn><a href="qdatastream.html">QDataStream</a> & <a name="operator-gt-gt"></a>operator>> ( <a href="qdatastream.html">QDataStream</a> & s, <a href="qstring.html">QString</a> & str )
	2425	</h3>
	2426
	2427	<p> Reads a string from the stream <em>s</em> into string <em>str</em>.
	2428	<p> See also <a href="datastreamformat.html">Format of the QDataStream operators</a>
	2429
	2430	<!-- eof -->
	2431	<hr><p>
	2432	This file is part of the <a href="index.html">Qt toolkit</a>.
	2433	Copyright © 1995-2007
	2434	<a href="http://www.trolltech.com/">Trolltech</a>. All Rights Reserved.<p><address><hr><div align=center>
	2435	<table width=100% cellspacing=0 border=0><tr>
	2436	<td>Copyright © 2007
	2437	<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
	2438	<td align=right><div align=right>Qt 3.3.8</div>
	2439	</table></div></address></body>
	2440	</html>

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

Context Navigation

source: trunk/doc/html/qstring.html

Download in other formats: