/****************************************************************************

**

** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).

** All rights reserved.

** Contact: Nokia Corporation (qt-info@nokia.com)

**

** This file is part of the documentation of the Qt Toolkit.

**

** $QT_BEGIN_LICENSE:LGPL$

** No Commercial Usage

** This file contains pre-release code and may not be distributed.

** You may use this file in accordance with the terms and conditions

** contained in the Technology Preview License Agreement accompanying

** this package.

**

** GNU Lesser General Public License Usage

** Alternatively, this file may be used under the terms of the GNU Lesser

** General Public License version 2.1 as published by the Free Software

** Foundation and appearing in the file LICENSE.LGPL included in the

** packaging of this file.  Please review the following information to

** ensure the GNU Lesser General Public License version 2.1 requirements

** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.

**

** In addition, as a special exception, Nokia gives you certain additional

** rights.  These rights are described in the Nokia Qt LGPL Exception

** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.

**

** If you have questions regarding the use of this file, please contact

** Nokia at qt-info@nokia.com.

**

**

**

**

**

**

**

**

** $QT_END_LICENSE$

**

****************************************************************************/

#include <QtGui>

#include <QApplication>

#include <stdio.h>

class Widget : public QWidget

{

public:

    Widget(QWidget *parent = 0);

    void constCharPointer();

    void constCharArray();

    void characterReference();

    void atFunction();

    void stringLiteral();

    void modify();

    void index();

    QString boolToString(bool b);

    void nullVsEmpty();

    void appendFunction();

    void argFunction();

    void chopFunction();

    void compareFunction();

    void compareSensitiveFunction();

    void containsFunction();

    void countFunction();

    void dataFunction();

    void endsWithFunction();

    void fillFunction();

    void fromRawDataFunction();

    void indexOfFunction();

    void firstIndexOfFunction();

    void insertFunction();

    void isNullFunction();

    void isEmptyFunction();

    void lastIndexOfFunction();

    void leftFunction();

    void leftJustifiedFunction();

    void leftRefFunction();

    void midFunction();

    void midRefFunction();

    void numberFunction();

    void prependFunction();

    void removeFunction();

    void replaceFunction();

    void reserveFunction();

    void resizeFunction();

    void rightFunction();

    void rightJustifiedFunction();

    void rightRefFunction();

    void sectionFunction();

    void setNumFunction();

    void simplifiedFunction();

    void sizeFunction();

    void splitFunction();

    void splitCaseSensitiveFunction();

    void sprintfFunction();

    void startsWithFunction();

    void toDoubleFunction();

    void toFloatFunction();

    void toIntFunction();

    void toLongFunction();

    void toLongLongFunction();

    void toLowerFunction();

    void toShortFunction();

    void toUIntFunction();

    void toULongFunction();

    void toULongLongFunction();

    void toUShortFunction();

    void toUpperFunction();

    void trimmedFunction();

    void truncateFunction();

    void plusEqualOperator();

    void arrayOperator();

};

Widget::Widget(QWidget *parent)

    : QWidget(parent)

{

}

void Widget::constCharPointer()

{

//! [0]

    QString str = "Hello";

//! [0]

}

void Widget::constCharArray()

{

//! [1]

    static const QChar data[4] = { 0x0055, 0x006e, 0x10e3, 0x03a3 };

    QString str(data, 4);

//! [1]

}

void Widget::characterReference()

{

//! [2]

    QString str;

    str.resize(4);

    str[0] = QChar('U');

    str[1] = QChar('n');

    str[2] = QChar(0x10e3);

    str[3] = QChar(0x03a3);

//! [2]

}

void Widget::atFunction()

{

//! [3]

    QString str;

    for (int i = 0; i < str.size(); ++i) {

        if (str.at(i) >= QChar('a') && str.at(i) <= QChar('f'))

            qDebug() << "Found character in range [a-f]";

    }

//! [3]

}

void Widget::stringLiteral()

{

//! [4]

    QString str;

    if (str == "auto" || str == "extern"

            || str == "static" || str == "register") {

        // ...

    }

//! [4]

}

void Widget::modify()

{

//! [5]

    QString str = "and";

    str.prepend("rock ");     // str == "rock and"

    str.append(" roll");        // str == "rock and roll"

    str.replace(5, 3, "&");   // str == "rock & roll"

//! [5]

}

void Widget::index()

{

//! [6]

    QString str = "We must be <b>bold</b>, very <b>bold</b>";

    int j = 0;

    while ((j = str.indexOf("<b>", j)) != -1) {

        qDebug() << "Found <b> tag at index position" << j;

        ++j;

    }

//! [6]

}

//! [7]

    QString Widget::boolToString(bool b)

    {

        QString result;

        if (b)

            result = "True";

        else

            result = "False";

        return result;

    }

//! [7]

void Widget::nullVsEmpty()

{

//! [8]

    QString().isNull();               // returns true

    QString().isEmpty();              // returns true

    QString("").isNull();             // returns false

    QString("").isEmpty();            // returns true

    QString("abc").isNull();          // returns false

    QString("abc").isEmpty();         // returns false

//! [8]

}

void Widget::appendFunction()

{

//! [9]

    QString x = "free";

    QString y = "dom";

    x.append(y);

    // x == "freedom"

//! [9]

//! [10]

    x.insert(x.size(), y);

//! [10]

}

void Widget::argFunction()

{

//! [11]

    QString i;           // current file's number

    QString total;       // number of files to process

    QString fileName;    // current file's name

    QString status = QString("Processing file %1 of %2: %3")

                    .arg(i).arg(total).arg(fileName);

//! [11]

//! [12] //! [13]

    QString str;

//! [12]

    str = "%1 %2";

    str.arg("%1f", "Hello");        // returns "%1f Hello"

    str.arg("%1f").arg("Hello");    // returns "Hellof %2"

//! [13]

//! [14]

    str = QString("Decimal 63 is %1 in hexadecimal")

            .arg(63, 0, 16);

    // str == "Decimal 63 is 3f in hexadecimal"

    QLocale::setDefault(QLocale(QLocale::English, QLocale::UnitedStates));

    str = QString("%1 %L2 %L3")

            .arg(12345)

            .arg(12345)

            .arg(12345, 0, 16);

    // str == "12345 12,345 3039"

//! [14]

}

void Widget::chopFunction()

{

//! [15]

    QString str("LOGOUT\r\n");

    str.chop(2);

    // str == "LOGOUT"

//! [15]

}

void Widget::compareFunction()

{

    int x = QString::compare("auto", "auto");   // x == 0

    int y = QString::compare("auto", "car");    // y < 0

    int z = QString::compare("car", "auto");    // z > 0

}

void Widget::compareSensitiveFunction()

{

//! [16]

    int x = QString::compare("aUtO", "AuTo", Qt::CaseInsensitive);  // x == 0

    int y = QString::compare("auto", "Car", Qt::CaseSensitive);     // y > 0

    int z = QString::compare("auto", "Car", Qt::CaseInsensitive);   // z < 0

//! [16]

}

void Widget::containsFunction()

{

//! [17]

    QString str = "Peter Pan";

    str.contains("peter", Qt::CaseInsensitive);    // returns true

//! [17]

}

void Widget::countFunction()

{

//! [18]

    QString str = "banana and panama";

    str.count(QRegExp("a[nm]a"));    // returns 4

//! [18]

}

void Widget::dataFunction()

{

//! [19]

    QString str = "Hello world";

    QChar *data = str.data();

    while (!data->isNull()) {

        qDebug() << data->unicode();

        ++data;

    }

//! [19]

}

void Widget::endsWithFunction()

{

//! [20]

    QString str = "Bananas";

    str.endsWith("anas");         // returns true

    str.endsWith("pple");         // returns false

//! [20]

}

void Widget::fillFunction()

{

//! [21]

    QString str = "Berlin";

    str.fill('z');

    // str == "zzzzzz"

    str.fill('A', 2);

    // str == "AA"

//! [21]

}

void Widget::fromRawDataFunction()

{

//! [22]

     QRegExp pattern;

     static const QChar unicode[] = {

             0x005A, 0x007F, 0x00A4, 0x0060,

             0x1009, 0x0020, 0x0020};

     int size = sizeof(unicode) / sizeof(QChar);

     QString str = QString::fromRawData(unicode, size);

     if (str.contains(QRegExp(pattern))) {

         // ...

//! [22] //! [23]

     }

//! [23]

}

void Widget::indexOfFunction()

{

//! [24]

    QString x = "sticky question";

    QString y = "sti";

    x.indexOf(y);               // returns 0

    x.indexOf(y, 1);            // returns 10

    x.indexOf(y, 10);           // returns 10

    x.indexOf(y, 11);           // returns -1

//! [24]

}

void Widget::firstIndexOfFunction()

{

//! [25]

    QString str = "the minimum";

    str.indexOf(QRegExp("m[aeiou]"), 0);       // returns 4

//! [25]

}

void Widget::insertFunction()

{

//! [26]

    QString str = "Meal";

    str.insert(1, QString("ontr"));

    // str == "Montreal"

//! [26]

}

void Widget::isEmptyFunction()

{

//! [27]

    QString().isEmpty();            // returns true

    QString("").isEmpty();          // returns true

    QString("x").isEmpty();         // returns false

    QString("abc").isEmpty();       // returns false

//! [27]

}

void Widget::isNullFunction()

{

//! [28]

    QString().isNull();             // returns true

    QString("").isNull();           // returns false

    QString("abc").isNull();        // returns false

//! [28]

}

void Widget::lastIndexOfFunction()

{

//! [29]

    QString x = "crazy azimuths";

    QString y = "az";

    x.lastIndexOf(y);           // returns 6

    x.lastIndexOf(y, 6);        // returns 6

    x.lastIndexOf(y, 5);        // returns 2

    x.lastIndexOf(y, 1);        // returns -1

//! [29]

//! [30]

    QString str = "the minimum";

    str.lastIndexOf(QRegExp("m[aeiou]"));      // returns 8

//! [30]

}

void Widget::leftFunction()

{

//! [31]

    QString x = "Pineapple";

    QString y = x.left(4);      // y == "Pine"

//! [31]

}

void Widget::leftJustifiedFunction()

{

//! [32]

    QString s = "apple";

    QString t = s.leftJustified(8, '.');    // t == "apple..."

//! [32]

//! [33]

    QString str = "Pineapple";

    str = str.leftJustified(5, '.', true);    // str == "Pinea"

//! [33]

}

void Widget::midFunction()

{

//! [34]

    QString x = "Nine pineapples";

    QString y = x.mid(5, 4);            // y == "pine"

    QString z = x.mid(5);               // z == "pineapples"

//! [34]

}

void Widget::numberFunction()

{

//! [35]

    long a = 63;

    QString s = QString::number(a, 16);             // s == "3f"

    QString t = QString::number(a, 16).toUpper();     // t == "3F"

//! [35]

}

void Widget::prependFunction()

{

//! [36]

    QString x = "ship";

    QString y = "air";

    x.prepend(y);

    // x == "airship"

//! [36]

}

void Widget::removeFunction()

{

//! [37]

    QString s = "Montreal";

    s.remove(1, 4);

    // s == "Meal"

//! [37]

//! [38]

    QString t = "Ali Baba";

    t.remove(QChar('a'), Qt::CaseInsensitive);

    // t == "li Bb"

//! [38]

//! [39]

    QString r = "Telephone";

    r.remove(QRegExp("[aeiou]."));

    // r == "The"

//! [39]

}

void Widget::replaceFunction()

{

//! [40]

    QString x = "Say yes!";

    QString y = "no";

    x.replace(4, 3, y);

    // x == "Say no!"

//! [40]

//! [41]

    QString str = "colour behaviour flavour neighbour";

    str.replace(QString("ou"), QString("o"));

    // str == "color behavior flavor neighbor"

//! [41]

//! [42]

    QString s = "Banana";

    s.replace(QRegExp("a[mn]"), "ox");

    // s == "Boxoxa"

//! [42]

//! [43]

    QString t = "A <i>bon mot</i>.";

    t.replace(QRegExp("<i>([^<]*)</i>"), "\\emph{\\1}");

    // t == "A \\emph{bon mot}."