src/corelib/tools/qstring.cpp File Reference

#include "qstringlist.h"
#include "qregexp.h"
#include "qunicodetables_p.h"
#include <qtextcodec.h>
#include <qdatastream.h>
#include <qlist.h>
#include "qlocale.h"
#include "qlocale_p.h"
#include "qstringmatcher.h"
#include "qtools_p.h"
#include "qhash.h"
#include "qdebug.h"
#include <limits.h>
#include <string.h>
#include <stdlib.h>
#include <stdio.h>
#include <stdarg.h>

Include dependency graph for qstring.cpp:

Go to the source code of this file.

Classes
class	qt_section_chunk
struct	ArgEscapeData
Defines
#define	LLONG_MAX   qint64_C(9223372036854775807)
#define	LLONG_MIN   (-LLONG_MAX - qint64_C(1))
#define	ULLONG_MAX   quint64_C(18446744073709551615)
#define	REHASH(a)
#define	CSTR_LESS_THAN   1
#define	CSTR_EQUAL   2
#define	CSTR_GREATER_THAN   3
#define	QT_MAX_FLOAT   3.4028234663852886e+38
Functions
static int	ucstrcmp (const QString &as, const QString &bs)
static int	ucstricmp (const QString &as, const QString &bs)
static int	ucstrncmp (const QChar *a, const QChar *b, int l)
static int	ucstrnicmp (const QChar *a, const QChar *b, int l)
bool	qIsUpper (char ch)
bool	qIsDigit (char ch)
char	qToLower (char ch)
static ushort *	addOne (ushort *qch, QString &str)
static ArgEscapeData	findArgEscapes (const QString &s)
static QString	replaceArgEscapes (const QString &s, const ArgEscapeData &d, int field_width, const QString &arg, const QString &larg, const QChar &fillChar=QLatin1Char(' '))
QDataStream &	operator<< (QDataStream &out, const QString &str)
QDataStream &	operator>> (QDataStream &in, QString &str)

---

Define Documentation

#define CSTR_EQUAL   2

Definition at line 4151 of file qstring.cpp.

#define CSTR_GREATER_THAN   3

Definition at line 4152 of file qstring.cpp.

Referenced by QString::localeAwareCompare().

#define CSTR_LESS_THAN   1

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. Compares this string with the other string and returns an integer less than, equal to, or greater than zero if this string is less than, equal to, or greater than the other string.

Same as {localeAwareCompare(*this, other)}.

Definition at line 4150 of file qstring.cpp.

Referenced by QString::localeAwareCompare().

#define LLONG_MAX   qint64_C(9223372036854775807)

Definition at line 50 of file qstring.cpp.

#define LLONG_MIN   (-LLONG_MAX - qint64_C(1))

Definition at line 53 of file qstring.cpp.

#define QT_MAX_FLOAT   3.4028234663852886e+38

Returns the string converted to a float value.

If a conversion error occurs, *{ok} is set to false; otherwise {ok} is set to true. Returns 0.0 if the conversion fails.

Example:

snippets/qstring/main.cpp Widget::toFloatFunction() QString str1 str2.toFloat(&ok)

See also:

number(), toDouble(), toInt()

Definition at line 5153 of file qstring.cpp.

#define REHASH

(

a

)

Value:

if (sl_minus_1 < (int)sizeof(int) * CHAR_BIT)       \
        hashHaystack -= (a) << sl_minus_1; \
    hashHaystack <<= 1

Definition at line 1936 of file qstring.cpp.

#define ULLONG_MAX   quint64_C(18446744073709551615)

Definition at line 56 of file qstring.cpp.

---

Function Documentation

static ushort* addOne	(	ushort *	qch,
		QString &	str
	)			[static]

Definition at line 3328 of file qstring.cpp.

References QString::data(), QString::length(), QString::resize(), and QString::utf16().

Referenced by QString::fromUtf8().

{
    long sidx = qch - str.utf16();
    str.resize(str.length()+1);
    return (ushort *)str.data() + sidx;
}

Here is the call graph for this function:

static ArgEscapeData findArgEscapes

(

const QString &

s

)

[static]

Definition at line 5548 of file qstring.cpp.

References c, d, Qt::escape(), and s.

Referenced by QString::arg().

{
    const QChar *uc_begin = s.unicode();
    const QChar *uc_end = uc_begin + s.length();

    ArgEscapeData d;

    d.min_escape = INT_MAX;
    d.occurrences = 0;
    d.escape_len = 0;
    d.locale_occurrences = 0;

    const QChar *c = uc_begin;
    while (c != uc_end) {
        while (c != uc_end && c->unicode() != '%')
            ++c;

        if (c == uc_end)
            break;
        const QChar *escape_start = c;
        if (++c == uc_end)
            break;

        bool locale_arg = false;
        if (c->unicode() == 'L') {
            locale_arg = true;
            if (++c == uc_end)
                break;
        }

        if (c->digitValue() == -1)
            continue;

        int escape = c->digitValue();
        ++c;

        if (c != uc_end && c->digitValue() != -1) {
            escape = (10 * escape) + c->digitValue();
            ++c;
        }

        if (escape > d.min_escape)
            continue;

        if (escape < d.min_escape) {
            d.min_escape = escape;
            d.occurrences = 0;
            d.escape_len = 0;
            d.locale_occurrences = 0;
        }

        ++d.occurrences;
        if (locale_arg)
            ++d.locale_occurrences;
        d.escape_len += c - escape_start;
    }
    return d;
}

Here is the call graph for this function:

QDataStream& operator<<	(	QDataStream &	out,
		const QString &	str
	)			[related]

Definition at line 6434 of file qstring.cpp.

{
    if (out.version() == 1) {
        out << str.toLatin1();
    } else {
        if (!str.isNull() || out.version() < 3) {
            int byteOrder = out.byteOrder();
            const QChar* ub = str.unicode();
            static const uint auto_size = 1024;
            char t[auto_size];
            char *b;
            if (str.length()*sizeof(QChar) > auto_size) {
                b = new char[str.length()*sizeof(QChar)];
            } else {
                b = t;
            }
            int l = str.length();
            char *c=b;
            while (l--) {
                if (byteOrder == QDataStream::BigEndian) {
                    *c++ = (char)ub->row();
                    *c++ = (char)ub->cell();
                } else {
                    *c++ = (char)ub->cell();
                    *c++ = (char)ub->row();
                }
                ub++;
            }
            out.writeBytes(b, sizeof(QChar)*str.length());
            if (str.length()*sizeof(QChar) > auto_size)
                delete [] b;
        } else {
            // write null marker
            out << (quint32)0xffffffff;
        }
    }
    return out;
}

QDataStream& operator>>	(	QDataStream &	in,
		QString &	str
	)			[related]

Definition at line 6482 of file qstring.cpp.

{
#ifdef QT_QSTRING_UCS_4
#if defined(Q_CC_GNU)
#warning "operator>> not working properly"
#endif
#endif

    if (in.version() == 1) {
        QByteArray l;
        in >> l;
        str = QString::fromLatin1(l);
    } else {
        quint32 bytes = 0;
        in >> bytes;                                  // read size of string
        if (bytes == 0xffffffff) {                    // null string
            str.clear();
        } else if (bytes > 0) {                       // not empty
            if (bytes & 0x1) {
                str.clear();
                in.setStatus(QDataStream::ReadCorruptData);
                return in;
            }

            const quint32 Step = 1024 * 1024;
            quint32 len = bytes / 2;
            quint32 allocated = 0;

            while (allocated < len) {
                int blockSize = qMin(Step, len - allocated);
                str.resize(allocated + blockSize);
                if (in.readRawData(reinterpret_cast<char *>(str.data()) + allocated * 2,
                                   blockSize * 2) != blockSize * 2) {
                    str.clear();
                    in.setStatus(QDataStream::ReadPastEnd);
                    return in;
                }
                allocated += blockSize;
            }

            if ((in.byteOrder() == QDataStream::BigEndian)
                    != (QSysInfo::ByteOrder == QSysInfo::BigEndian)) {
                ushort *data = reinterpret_cast<ushort *>(str.data());
                while (len--) {
                    *data = (*data >> 8) | (*data << 8);
                    ++data;
                }
            }
        } else {
            str = QLatin1String("");
        }
    }
    return in;
}

bool qIsDigit

(

char

ch

)

[inline]

Definition at line 124 of file qstring.cpp.

Referenced by QString::vsprintf().

{
    return ch >= '0' && ch <= '9';
}

bool qIsUpper

(

char

ch

)

[inline]

Definition at line 119 of file qstring.cpp.

{
    return ch >= 'A' && ch <= 'Z';
}

char qToLower

(

char

ch

)

[inline]

Definition at line 129 of file qstring.cpp.

{
    if (ch >= 'A' && ch <= 'Z')
        return ch - 'A' + 'a';
    else
        return ch;
}

static QString replaceArgEscapes	(	const QString &	s,
		const ArgEscapeData &	d,
		int	field_width,
		const QString &	arg,
		const QString &	larg,
		const QChar &	fillChar = QLatin1Char(' ')
	)			[static]

Definition at line 5607 of file qstring.cpp.

References c, d, QUnicodeTables::digitValue(), Qt::escape(), i, QString::length(), qMax(), QString::resize(), s, and QString::unicode().

Referenced by QString::arg().

{
    const QChar *uc_begin = s.unicode();
    const QChar *uc_end = uc_begin + s.length();

    int abs_field_width = qAbs(field_width);
    int result_len = s.length()
                     - d.escape_len
                     + (d.occurrences - d.locale_occurrences)
                     *qMax(abs_field_width, arg.length())
                     + d.locale_occurrences
                     *qMax(abs_field_width, larg.length());

    QString result;
    result.resize(result_len);
    QChar *result_buff = (QChar*) result.unicode();

    QChar *rc = result_buff;
    const QChar *c = uc_begin;
    int repl_cnt = 0;
    while (c != uc_end) {
        /* We don't have to check if we run off the end of the string with c,
           because as long as d.occurrences > 0 we KNOW there are valid escape
           sequences. */

        const QChar *text_start = c;

        while (c->unicode() != '%')
            ++c;

        const QChar *escape_start = c++;

        bool locale_arg = false;
        if (c->unicode() == 'L') {
            locale_arg = true;
            ++c;
        }

        int escape = c->digitValue();
        if (escape != -1) {
            if (c + 1 != uc_end && (c + 1)->digitValue() != -1) {
                escape = (10 * escape) + (c + 1)->digitValue();
                ++c;
            }
        }

        if (escape != d.min_escape) {
            memcpy(rc, text_start, (c - text_start)*sizeof(QChar));
            rc += c - text_start;
        }
        else {
            ++c;

            memcpy(rc, text_start, (escape_start - text_start)*sizeof(QChar));
            rc += escape_start - text_start;

            uint pad_chars;
            if (locale_arg)
                pad_chars = qMax(abs_field_width, larg.length()) - larg.length();
            else
                pad_chars = qMax(abs_field_width, arg.length()) - arg.length();

            if (field_width > 0) { // left padded
                for (uint i = 0; i < pad_chars; ++i)
                    (rc++)->unicode() = fillChar.unicode();
            }

            if (locale_arg) {
                memcpy(rc, larg.unicode(), larg.length()*sizeof(QChar));
                rc += larg.length();
            }
            else {
                memcpy(rc, arg.unicode(), arg.length()*sizeof(QChar));
                rc += arg.length();
            }

            if (field_width < 0) { // right padded
                for (uint i = 0; i < pad_chars; ++i)
                    (rc++)->unicode() = fillChar.unicode();
            }

            if (++repl_cnt == d.occurrences) {
                memcpy(rc, c, (uc_end - c)*sizeof(QChar));
                rc += uc_end - c;
                Q_ASSERT(rc - result_buff == result_len);
                c = uc_end;
            }
        }
    }
    Q_ASSERT(rc == result_buff + result_len);

    return result;
}

Here is the call graph for this function:

static int ucstrcmp	(	const QString &	as,
		const QString &	bs
	)			[static]

Definition at line 68 of file qstring.cpp.

References a, b, l, QString::length(), qMin(), and QString::unicode().

Referenced by QString::compare(), QString::localeAwareCompare(), and QString::operator<().

{
    const QChar *a = as.unicode();
    const QChar *b = bs.unicode();
    if (a == b)
        return 0;
    int l = qMin(as.length(),bs.length());
    while (l-- && *a == *b)
        a++,b++;
    if (l == -1)
        return (as.length()-bs.length());
    return a->unicode() - b->unicode();
}

Here is the call graph for this function:

static int ucstricmp	(	const QString &	as,
		const QString &	bs
	)			[static]

Definition at line 82 of file qstring.cpp.

References a, b, l, QString::length(), QUnicodeTables::lower(), qMin(), and QString::unicode().

Referenced by bestFoundry(), QFontDatabase::bold(), QString::compare(), QFontDatabasePrivate::family(), QFontDatabase::font(), QtFontFamily::foundry(), QFontDatabase::isBitmapScalable(), QFontDatabase::isSmoothlyScalable(), QFontDatabase::italic(), match(), QFontDatabase::pointSizes(), QFontDatabase::smoothSizes(), QFontDatabase::styles(), and QFontDatabase::weight().

{
    const QChar *a = as.unicode();
    const QChar *b = bs.unicode();
    if (a == b)
        return 0;
    if (a == 0)
        return 1;
    if (b == 0)
        return -1;
    int l=qMin(as.length(),bs.length());
    while (l-- && QUnicodeTables::lower(*a) == QUnicodeTables::lower(*b))
        a++,b++;
    if (l==-1)
        return (as.length()-bs.length());
    return QUnicodeTables::lower(*a).unicode() - QUnicodeTables::lower(*b).unicode();
}

Here is the call graph for this function:

static int ucstrncmp	(	const QChar *	a,
		const QChar *	b,
		int	l
	)			[static]

Definition at line 100 of file qstring.cpp.

References a, and b.

Referenced by QString::indexOf(), and QString::lastIndexOf().

{
    while (l-- && *a == *b)
        a++,b++;
    if (l==-1)
        return 0;
    return a->unicode() - b->unicode();
}

static int ucstrnicmp	(	const QChar *	a,
		const QChar *	b,
		int	l
	)			[static]

Definition at line 109 of file qstring.cpp.

References a, b, and QUnicodeTables::lower().

Referenced by QString::indexOf(), and QString::lastIndexOf().

{
    while (l-- && QUnicodeTables::lower(*a) == QUnicodeTables::lower(*b))
        a++,b++;
    if (l==-1)
        return 0;
    return QUnicodeTables::lower(*a).unicode() - QUnicodeTables::lower(*b).unicode();
}

Here is the call graph for this function:

---