Пространство имён QTest

Пространство имён QTest содержит все функции и объявления, относящиеся к Qt Test. Подробнее...

• Устаревшие члены

Классы

Типы

Функции

Макросы

Подробное описание

Пространство имен QTest содержит все функции и объявления, относящиеся к Qt Test.

См. Обзор Qt Test для получения информации о том, как писать модульные тесты.

Документация типов

перечисление QTest::AttributeIndex

Это перечисление нумерует различные тесты.

Перечисление QTest::KeyAction

Это перечисление описывает возможные действия для обработки клавиш.

Перечисление QTest::LogElementType

Перечисление определяет типы сообщений протокола тестирования.

Перечисление QTest::MouseAction

Это перечисление описывает возможные действия для обработки мыши.

Перечисление QTest::QBenchmarkMetric

Это перечисление содержит все элементы, которые можно тестировать на производительность.

Обратите внимание, что WalltimeNanoseconds и BytesAllocated предоставляются только для использования через setBenchmarkResult(), и результаты по этим метрикам не могут быть автоматически предоставлены фреймворком QTest.

Это перечисление было введено или изменено в Qt 4.7.

См. также QTest::benchmarkMetricName() и QTest::benchmarkMetricUnit().

Перечисление QTest::TestFailMode

Этот перечисление описывает режимы обработки ожидаемой ошибки макросов QVERIFY() или QCOMPARE().

См. также QEXPECT_FAIL().

Документация функций

void QTest::addColumn(const char *name, T *dummy = Q_NULLPTR)

Добавляет столбец типа T в текущие данные теста. name — имя столбца. dummy — обходной вариант для некорректных компиляторов и может быть проигнорирован.

Для заполнения столбца значениями можно использовать newRow(). Используйте QFETCH() для получения данных в самом тесте.

Пример:

void myTestFunction_data() {
    QTest::addColumn<int>("intval");
    QTest::addColumn<QString>("str");
    QTest::addColumn<double>("dbl");

    QTest::newRow("row1") << 1 << "hello" << 1.5;
}

Для добавления пользовательских типов в тестовые данные, тип должен быть зарегистрирован с помощью QMetaType через Q_DECLARE_METATYPE().

Примечание: Этот макрос может быть использован только в функции данных теста, которая вызывается тестовым фреймворком.

См. Data Driven Testing для более подробного примера.

См. также QTest::newRow(), QFETCH() и QMetaType.

const char *QTest::benchmarkMetricName(QBenchmarkMetric metric)

Возвращает значение перечисления metric в виде строки символов.

Эта функция была добавлена в Qt 4.7.

const char *QTest::benchmarkMetricUnit(QBenchmarkMetric metric)

Возвращает единицы измерения для заданного metric.

Эта функция была добавлена в Qt 4.7.

const char *QTest::currentAppName()

Возвращает имя выполняемого в данный момент бинарного файла.

const char *QTest::currentDataTag()

Возвращает имя текущих тестовых данных. Если у теста нет назначенных тестовых данных, функция возвращает 0.

bool QTest::currentTestFailed()

Возвращает true если текущая тестовая функция завершилась неудачно, в противном случае false.

const char *QTest::currentTestFunction()

Возвращает имя текущей выполняемой тестовой функции.

Пример:

void MyTestClass::cleanup()
{
    if (qstrcmp(currentTestFunction(), "myDatabaseTest") == 0) {
        // clean up all database connections
        closeAllDatabases();
    }
}

void QTest::ignoreMessage(QtMsgType type, const char *message)

Игнорирует сообщения, созданные с помощью qDebug(), qInfo() или qWarning(). Если сообщение с соответствующим type выводится, оно удаляется из протокола теста. Если тест завершился, а сообщение не было выведено, в протокол теста добавляется ошибка теста.

Примечание: Вызов этой функции игнорирует только одно сообщение. Если сообщение, которое вы хотите проигнорировать, выводится дважды, необходимо дважды вызвать ignoreMessage().

Пример:

QDir dir;

QTest::ignoreMessage(QtWarningMsg, "QDir::mkdir: Empty or null file name(s)");
dir.mkdir("");

В примере выше проверяется, что QDir::mkdir() выводит правильное предупреждение при вызове с некорректным именем файла.

void QTest::ignoreMessage(QtMsgType type, const QRegularExpression &messagePattern)

Это перегруженная функция.

Игнорирует сообщения, созданные с помощью qDebug(), qInfo() или qWarning(). Если выводится сообщение, соответствующее messagePattern с соответствующим type, оно удаляется из протокола теста. Если тест завершился, а сообщение не было выведено, в протокол теста добавляется ошибка теста.

Примечание: Вызов этой функции игнорирует только одно сообщение. Если сообщение, которое вы хотите проигнорировать, выводится дважды, необходимо дважды вызвать ignoreMessage().

Эта функция была добавлена в Qt 5.3.

[static] void QTest::keyClick(QWidget *widget, Qt::Key key, Qt::KeyboardModifiers modifier = Qt::NoModifier, int delay = -1)

Имитирует нажатие клавиши key с необязательными modifier на widget. Если delay больше 0, тест подождёт delay миллисекунд перед нажатием клавиши.

Примеры:

QTest::keyClick(myWidget, Qt::Key_Escape);

QTest::keyClick(myWidget, Qt::Key_Escape, Qt::ShiftModifier, 200);

Первый пример имитирует нажатие клавиши escape на myWidget без каких-либо модификаторов клавиатуры и без задержки. Второй пример имитирует нажатие shift-escape на myWidget после 200-миллисекундной задержки теста.

См. также QTest::keyClicks().

[static] void QTest::keyClick(QWindow *window, char key, Qt::KeyboardModifiers modifier = Qt::NoModifier, int delay = -1)

Это перегруженная функция.

Имитирует нажатие клавиши key с необязательными modifier на window. Если delay больше 0, тест подождёт delay миллисекунд перед нажатием клавиши.

Пример:

QTest::keyClick(myWindow, 'a');

В примере выше имитируется нажатие a на myWindow без каких-либо модификаторов клавиатуры и без задержки теста.

Эта функция была добавлена в Qt 5.0.

См. также QTest::keyClicks().

[static] void QTest::keyClick(QWidget *widget, char key, Qt::KeyboardModifiers modifier = Qt::NoModifier, int delay = -1)

Это перегруженная функция.

Имитирует нажатие клавиши key с необязательными modifier на widget. Если delay больше 0, тест подождёт delay миллисекунд перед нажатием клавиши.

Пример:

QTest::keyClick(myWidget, 'a');

В примере выше имитируется нажатие a на myWidget без каких-либо модификаторов клавиатуры и без задержки теста.

См. также QTest::keyClicks().

[static] void QTest::keyClick(QWindow *window, Qt::Key key, Qt::KeyboardModifiers modifier = Qt::NoModifier, int delay = -1)

Это перегруженная функция.

Имитирует нажатие клавиши key с необязательными modifier на window. Если delay больше 0, тест подождёт delay миллисекунд перед нажатием клавиши.

Примеры:

QTest::keyClick(myWindow, Qt::Key_Escape);

QTest::keyClick(myWindow, Qt::Key_Escape, Qt::ShiftModifier, 200);

Первый пример имитирует нажатие клавиши escape на myWindow без каких-либо модификаторов клавиатуры и без задержки. Второй пример имитирует нажатие shift-escape на myWindow после 200-миллисекундной задержки теста.

Эта функция была добавлена в Qt 5.0.

См. также QTest::keyClicks().

[static] void QTest::keyClicks(QWidget *widget, const QString &sequence, Qt::KeyboardModifiers modifier = Qt::NoModifier, int delay = -1)

Имитирует нажатие последовательности клавиш sequence на widget. Необязательно, можно указать модификатор клавиатуры modifier и задержку (в миллисекундах) delay перед каждым нажатием клавиши.

Пример:

QTest::keyClicks(myWidget, "hello world");

В примере выше имитируется нажатие последовательности клавиш, представляющих "hello world", на myWidget без каких-либо модификаторов клавиатуры и без задержки теста.

См. также QTest::keyClick().

[static] void QTest::keyEvent(KeyAction action, QWidget *widget, Qt::Key key, Qt::KeyboardModifiers modifier = Qt::NoModifier, int delay = -1)

Отправляет событие Qt клавиши на widget с заданной key и ассоциированным action. Необязательно можно указать модификатор клавиатуры modifier и задержку (в миллисекундах) delay перед отправкой события.

[static] void QTest::keyEvent(KeyAction action, QWindow *window, Qt::Key key, Qt::KeyboardModifiers modifier = Qt::NoModifier, int delay = -1)

Это перегруженный метод.

Отправляет событие Qt о нажатии клавиши на window с заданным key и связанным action. Необязательно, можно указать модификатор клавиатуры и delay (в миллисекундах) перед отправкой события.

Этот метод был представлен в Qt 5.0.

[static] void QTest::keyEvent(KeyAction action, QWidget *widget, char ascii, Qt::KeyboardModifiers modifier = Qt::NoModifier, int delay = -1)

Это перегруженный метод.

Отправляет событие Qt о нажатии клавиши на widget с заданным символом ascii и связанным action. Необязательно, можно указать модификатор клавиатуры и delay (в миллисекундах) перед отправкой события.

[static] void QTest::keyEvent(KeyAction action, QWindow *window, char ascii, Qt::KeyboardModifiers modifier = Qt::NoModifier, int delay = -1)

Это перегруженный метод.

Отправляет событие Qt о нажатии клавиши на window с заданным символом ascii и связанным action. Необязательно, можно указать модификатор клавиатуры и delay (в миллисекундах) перед отправкой события.

Этот метод был представлен в Qt 5.0.

[static] void QTest::keyPress(QWidget *widget, Qt::Key key, Qt::KeyboardModifiers modifier = Qt::NoModifier, int delay = -1)

Имитирует нажатие клавиши key с необязательным modifier на widget. Если delay больше 0, тест подождет delay миллисекунд перед нажатием клавиши.

Примечание: В какой-то момент необходимо отпустить клавишу, используя keyRelease().

См. также QTest::keyRelease() и QTest::keyClick().

[static] void QTest::keyPress(QWindow *window, Qt::Key key, Qt::KeyboardModifiers modifier = Qt::NoModifier, int delay = -1)

Это перегруженный метод.

Имитирует нажатие клавиши key с необязательным modifier на window. Если delay больше 0, тест подождет delay миллисекунд перед нажатием клавиши.

Примечание: В какой-то момент необходимо отпустить клавишу, используя keyRelease().

Этот метод был представлен в Qt 5.0.

См. также QTest::keyRelease() и QTest::keyClick().

[static] void QTest::keyPress(QWidget *widget, char key, Qt::KeyboardModifiers modifier = Qt::NoModifier, int delay = -1)

Это перегруженный метод.

Имитирует нажатие клавиши key с необязательным modifier на widget. Если delay больше 0, тест подождет delay миллисекунд перед нажатием клавиши.

Примечание: В какой-то момент необходимо отпустить клавишу, используя keyRelease().

См. также QTest::keyRelease() и QTest::keyClick().

[static] void QTest::keyPress(QWindow *window, char key, Qt::KeyboardModifiers modifier = Qt::NoModifier, int delay = -1)

Это перегруженный метод.

Имитирует нажатие клавиши key с необязательным modifier на window. Если delay больше 0, тест подождет delay миллисекунд перед нажатием клавиши.

Примечание: В какой-то момент необходимо отпустить клавишу, используя keyRelease().

Этот метод был представлен в Qt 5.0.

См. также QTest::keyRelease() и QTest::keyClick().

[static] void QTest::keyRelease(QWidget *widget, Qt::Key key, Qt::KeyboardModifiers modifier = Qt::NoModifier, int delay = -1)

Имитирует отпускание клавиши key с необязательным modifier на widget. Если delay больше 0, тест подождет delay миллисекунд перед отпусканием клавиши.

См. также QTest::keyPress() и QTest::keyClick().

[static] void QTest::keyRelease(QWindow *window, Qt::Key key, Qt::KeyboardModifiers modifier = Qt::NoModifier, int delay = -1)

Это перегруженный метод.

Имитирует отпускание клавиши key с необязательным modifier на window. Если delay больше 0, тест подождет delay миллисекунд перед отпусканием клавиши.

Этот метод был представлен в Qt 5.0.

См. также QTest::keyPress() и QTest::keyClick().

[static] void QTest::keyRelease(QWidget *widget, char key, Qt::KeyboardModifiers modifier = Qt::NoModifier, int delay = -1)

Это перегруженный метод.

Имитирует отпускание клавиши key с необязательным modifier на widget. Если delay больше 0, тест подождет delay миллисекунд перед отпусканием клавиши.

См. также QTest::keyClick().

[static] void QTest::keyRelease(QWindow *window, char key, Qt::KeyboardModifiers modifier = Qt::NoModifier, int delay = -1)

Это перегруженный метод.

Имитирует отпускание клавиши key с необязательным modifier на window. Если delay больше 0, тест подождет delay миллисекунд перед отпусканием клавиши.

Этот метод был представлен в Qt 5.0.

См. также QTest::keyClick().

void QTest::mouseClick(QWidget *widget, Qt::MouseButton button, Qt::KeyboardModifiers modifier = Qt::KeyboardModifiers(), QPoint pos = QPoint(), int delay = -1)

Имитирует нажатие кнопки мыши button с необязательным modifier на widget. Позиция щелчка определяется pos; по умолчанию — центр виджета. Если задано delay, тест подождет указанное количество миллисекунд до нажатия и отпускания кнопки.

См. также QTest::mousePress() и QTest::mouseRelease().

void QTest::mouseClick(QWindow *window, Qt::MouseButton button, Qt::KeyboardModifiers stateKey = Qt::KeyboardModifiers(), QPoint pos = QPoint(), int delay = -1)

Это перегруженный метод.

Имитирует нажатие кнопки мыши button с необязательным stateKey модификатором на window. Позиция щелчка определяется pos; по умолчанию — центр окна. Если задано delay, тест подождет указанное количество миллисекунд до нажатия и отпускания кнопки.

Этот метод был представлен в Qt 5.0.

См. также QTest::mousePress() и QTest::mouseRelease().

void QTest::mouseDClick(QWidget *widget, Qt::MouseButton button, Qt::KeyboardModifiers modifier = Qt::KeyboardModifiers(), QPoint pos = QPoint(), int delay = -1)

Имитирует двойной щелчок мыши по кнопке с необязательным модификатором на виджете. Положение щелчка определяется pos; значение по умолчанию — центр виджета. Если указан delay, тест будет ожидать указанное количество миллисекунд перед каждым нажатием и отпусканием.

См. также QTest::mouseClick().

void QTest::mouseDClick(QWindow *window, Qt::MouseButton button, Qt::KeyboardModifiers stateKey = Qt::KeyboardModifiers(), QPoint pos = QPoint(), int delay = -1)

Это перегруженный метод.

Имитирует двойной щелчок мыши по кнопке с необязательным модификатором stateKey на окне. Положение щелчка определяется pos; значение по умолчанию — центр окна. Если указан delay, тест будет ожидать указанное количество миллисекунд перед каждым нажатием и отпусканием.

Данный метод был введён в Qt 5.0.

См. также QTest::mouseClick().

void QTest::mouseMove(QWidget *widget, QPoint pos = QPoint(), int delay = -1)

Перемещает указатель мыши к виджету. Если pos не указан, указатель мыши перемещается в центр виджета. Если задан delay (в миллисекундах), тест будет ожидать перед перемещением указателя.

void QTest::mouseMove(QWindow *window, QPoint pos = QPoint(), int delay = -1)

Это перегруженный метод.

Перемещает указатель мыши к окну. Если pos не указан, указатель мыши перемещается в центр окна. Если задан delay (в миллисекундах), тест будет ожидать перед перемещением указателя.

Данный метод был введён в Qt 5.0.

void QTest::mousePress(QWidget *widget, Qt::MouseButton button, Qt::KeyboardModifiers modifier = Qt::KeyboardModifiers(), QPoint pos = QPoint(), int delay = -1)

Имитирует нажатие кнопки мыши button с необязательным модификатором modifier на виджете. Положение задаётся pos; значение по умолчанию — центр виджета. Если delay указан, тест будет ожидать указанное количество миллисекунд перед нажатием.

См. также QTest::mouseRelease() и QTest::mouseClick().

void QTest::mousePress(QWindow *window, Qt::MouseButton button, Qt::KeyboardModifiers stateKey = Qt::KeyboardModifiers(), QPoint pos = QPoint(), int delay = -1)

Это перегруженный метод.

Имитирует нажатие кнопки мыши button с необязательным модификатором stateKey на окне. Положение задаётся pos; значение по умолчанию — центр окна. Если delay указан, тест будет ожидать указанное количество миллисекунд перед нажатием.

Данный метод был введён в Qt 5.0.

См. также QTest::mouseRelease() и QTest::mouseClick().

void QTest::mouseRelease(QWidget *widget, Qt::MouseButton button, Qt::KeyboardModifiers modifier = Qt::KeyboardModifiers(), QPoint pos = QPoint(), int delay = -1)

Имитирует отпускание кнопки мыши button с необязательным модификатором modifier на виджете. Положение отпускания определяется pos; значение по умолчанию — центр виджета. Если delay указан, тест будет ожидать указанное количество миллисекунд перед отпусканием кнопки.

См. также QTest::mousePress() и QTest::mouseClick().

void QTest::mouseRelease(QWindow *window, Qt::MouseButton button, Qt::KeyboardModifiers stateKey = Qt::KeyboardModifiers(), QPoint pos = QPoint(), int delay = -1)

Это перегруженный метод.

Имитирует отпускание кнопки мыши button с необязательным модификатором stateKey на окне. Положение отпускания определяется pos; значение по умолчанию — центр окна. Если delay указан, тест будет ожидать указанное количество миллисекунд перед отпусканием кнопки.

Данный метод был введён в Qt 5.0.

См. также QTest::mousePress() и QTest::mouseClick().

QTestData &QTest::newRow(const char *dataTag)

Добавляет новую строку к текущим тестовым данным. dataTag — имя тестовых данных, которое будет отображаться в выходных данных теста. Возвращает ссылку на QTestData, которую можно использовать для потоковой передачи данных.

Пример:

void myTestFunction_data()
{
    QTest::addColumn<QString>("aString");
    QTest::newRow("just hello") << QString("hello");
    QTest::newRow("a null string") << QString();
}

Примечание: Этот макрос может быть использован только в функции данных теста, вызываемой тестовой средой.

См. Тестирование с использованием данных для более подробного примера.

См. также addColumn() и QFETCH().

int QTest::qExec(QObject *testObject, int argc = 0, char **argv = Q_NULLPTR)

Выполняет тесты, объявленные в testObject. Кроме того, выполняются частные слоты initTestCase(), cleanupTestCase(), init() и cleanup() при их наличии. См. Создание теста для получения дополнительных сведений.

Можно предоставить аргументы командной строки argc и argv. Список распознаваемых аргументов см. в Аргументы командной строки Qt Test.

Следующий пример запустит все тесты в MyTestObject:

MyTestObject test1;
QTest::qExec(&test1);

Функция возвращает 0, если тесты не завершились неудачей, или значение, отличное от 0, если один или несколько тестов завершились неудачей, или в случае необработанных исключений. (Пропущенные тесты не влияют на возвращаемое значение.)

Для автономных тестовых приложений можно использовать удобный макрос QTEST_MAIN() для объявления функции main(), которая обрабатывает аргументы командной строки и выполняет тесты, избегая необходимости вызывать эту функцию явно.

Возвращаемое значение этой функции также является кодом завершения тестового приложения, когда используется макрос QTEST_MAIN().

Для автономных тестовых приложений эта функция не должна вызываться более одного раза, так как параметры командной строки для ведения протокола тестовых результатов в файлы и выполнения отдельных тестовых функций не будут работать корректно.

Примечание: Эта функция не реентерабельна, одновременно может выполняться только один тест. Тест, выполненный с помощью qExec(), не может запустить другой тест через qExec(), и потоки не разрешены для одновременного вызова qExec().

Если вы программно создали аргументы, а не получили их из аргументов в main(), вам, вероятно, будет интересно использовать QTest::qExec(QObject *, const QStringList &), так как он безопасен для Unicode.

См. также QTEST_MAIN().

int QTest::qExec(QObject *testObject, const QStringList &arguments)

Это перегруженный метод.

Ведёт себя идентично qExec(QObject *, int, char**), но принимает QStringList аргументов arguments вместо char** списка.

Данный метод был введён в Qt 4.4.

QSharedPointer<QTemporaryDir> QTest::qExtractTestData(const QString &dirName)

Извлекает директорию из ресурсов на диск. Содержимое извлекается рекурсивно в временную папку. Извлечённое содержимое удаляется автоматически, когда ссылка на возвращаемое значение выходит из области видимости.

dirName — имя директории для извлечения из ресурсов.

Возвращает временную директорию, куда были извлечены данные, или null в случае ошибок.

void QTest::qSleep(int ms)

Засыпает на ms миллисекунд, блокируя выполнение теста. qSleep() не будет обрабатывать события и сделает ваш тест неотзывчивым. В процессе засыпания могут сработать таймауты сетевых соединений. Используйте qWait(), чтобы сделать засыпание неблокирующим.

ms должно быть больше 0.

Примечание: Функция qSleep() вызывает либо nanosleep() на Unix, либо Sleep() на Windows, поэтому точность времени, затраченного в qSleep(), зависит от операционной системы.

Пример:

QTest::qSleep(250);

См. также qWait().

[static] void QTest::qWait(int ms)

Ожидает ms миллисекунд. Во время ожидания будут обрабатываться события, и ваш тест останется отзывчивым на события пользовательского интерфейса или сетевого взаимодействия.

Пример:

int i = 0;
while (myNetworkServerNotResponding() && i++ < 50)
    QTest::qWait(250);

Приведённый выше код будет ожидать ответа от сетевого сервера в течение максимального времени около 12,5 секунд.

См. такжеQTest::qSleep() и QSignalSpy::wait().

[static] bool QTest::qWaitForWindowActive(QWindow *window, int timeout = 5000)

Ожидает timeout миллисекунд или до тех пор, пока окно window не станет активным.

Возвращает true если окно window активное в течение timeout миллисекунд, в противном случае возвращает false.

Эта функция была добавлена в Qt 5.0.

См. такжеQTest::qWaitForWindowExposed() и QWindow::isActive().

[static] bool QTest::qWaitForWindowActive(QWidget *widget, int timeout = 1000)

Ожидает timeout миллисекунд или до тех пор, пока окно виджета widget не станет активным.

Возвращает true если окно виджета widget активно в течение timeout миллисекунд, в противном случае возвращает false.

Эта функция была добавлена в Qt 5.0.

См. такжеQTest::qWaitForWindowExposed() и QWidget::isActiveWindow().

[static] bool QTest::qWaitForWindowExposed(QWindow *window, int timeout = 5000)

Ожидает timeout миллисекунд или до тех пор, пока окно window не станет видимым. Возвращает true если окно window становится видимым в течение timeout миллисекунд, в противном случае возвращает false.

Эта функция полезна в основном для асинхронных систем, таких как X11, где окно отображается на экране некоторое время после того, как ему было указано отобразиться.

Эта функция была добавлена в Qt 5.0.

См. такжеQTest::qWaitForWindowActive() и QWindow::isExposed().

[static] bool QTest::qWaitForWindowExposed(QWidget *widget, int timeout = 1000)

Ожидает timeout миллисекунд или до тех пор, пока окно виджета widget не станет видимым. Возвращает true если окно виджета widget становится видимым в течение timeout миллисекунд, в противном случае возвращает false.

Эта функция полезна в основном для асинхронных систем, таких как X11, где окно отображается на экране некоторое время после того, как ему было указано отобразиться.

Эта функция была добавлена в Qt 5.0.

См. такжеQTest::qWaitForWindowActive().

void QTest::setBenchmarkResult(qreal result, QBenchmarkMetric metric)

Устанавливает результат бенчмарка для данной функции теста на result.

Используйте эту функцию, если хотите сообщить результаты бенчмарка без использования макроса QBENCHMARK. Используйте metric, чтобы указать, как Qt Test должен интерпретировать результаты.

Контекст результата будет именем функции теста и любыми тегами данных из функции _data. Эта функция может быть вызвана только один раз в каждой функции теста; последующие вызовы заменят ранее сообщённые результаты.

Обратите внимание, что аргумент командной строки -iterations не оказывает влияния на функции тестов без макроса QBENCHMARK.

Эта функция была добавлена в Qt 4.7.

char *QTest::toHexRepresentation(const char *ba, int length)

Возвращает указатель на строку, представляющую строку ba как последовательность шестнадцатеричных символов, разделённых пробелами. Если входная строка слишком длинная, она усекается. Усечение в возвращаемой строке обозначается многоточием в конце.

length — длина строки ba.

char *QTest::toString(const QHostAddress &addr)

char *QTest::toString(const QLatin1String &string)

Это перегруженная функция.

Возвращает текстовое представление заданной строки string.

char *QTest::toString(const QByteArray &ba)

Это перегруженная функция.

Возвращает текстовое представление массива байтов ba.

См. такжеQTest::toHexRepresentation().

char *QTest::toString(const QTime &time)

Это перегруженная функция.

Возвращает текстовое представление заданного времени time.

char *QTest::toString(const QDate &date)

Это перегруженная функция.

Возвращает текстовое представление заданной даты date.

char *QTest::toString(const QDateTime &dateTime)

Это перегруженная функция.

Возвращает текстовое представление даты и времени, заданных dateTime.

char *QTest::toString(const QChar &character)

Это перегруженная функция.

Возвращает текстовое представление заданного символа character.

char *QTest::toString(const QPoint &point)

Это перегруженная функция.

Возвращает текстовое представление заданной точки point.

char *QTest::toString(const QSize &size)

Это перегруженная функция.

Возвращает текстовое представление заданного размера size.

char *QTest::toString(const QRect &rectangle)

Это перегруженная функция.

Возвращает текстовое представление заданного прямоугольника rectangle.

char *QTest::toString(const QPointF &point)

Это перегруженная функция.

Возвращает текстовое представление заданной точки point.

char *QTest::toString(const QSizeF &size)

Это перегруженная функция.

Возвращает текстовое представление заданного размера size.

char *QTest::toString(const QRectF &rectangle)

Это перегруженная функция.

Возвращает текстовое представление заданного прямоугольника rectangle.

char *QTest::toString(const QUrl &url)

Это перегруженная функция.

Возвращает текстовое представление заданного URL-адреса url.

Эта функция была добавлена в Qt 4.4.

char *QTest::toString(const QVariant &variant)

Это перегруженная функция.

Возвращает текстовое представление заданного значения variant.

char *QTest::toString(const QString &string)

Это перегруженная функция.

Возвращает текстовое представление заданной строки string.

char *QTest::toString(QSizePolicy::Policy p)

Это перегруженная функция.

Возвращает текстовое представление политики p.

Эта функция была добавлена в Qt 5.5.

char *QTest::toString(QSizePolicy::ControlTypes cts)

Это перегруженная функция.

Возвращает текстовое представление типов элементов управления cts.

Эта функция была добавлена в Qt 5.5.

char *QTest::toString(QSizePolicy::ControlType ct)

Это перегруженная функция.

Возвращает текстовое представление типа элемента управления ct.

Эта функция была добавлена в Qt 5.5.

char *QTest::toString(QSizePolicy sp)

Это перегруженная функция.

Возвращает текстовое представление политики размера sp.

Эта функция была добавлена в Qt 5.5.

char *QTest::toString(const T &value)

Возвращает текстовое представление value. Эта функция используется функцией QCOMPARE() для вывода подробной информации в случае сбоя теста.

Вы можете добавить специализации или перегрузки этой функции в свой тест, чтобы включить подробный вывод.

Примечание: Начиная с Qt 5.5, следует отдавать предпочтение предоставлению функции toString() в пространстве имён типа вместо специализации этого шаблона. Если ваш код должен продолжать работать с QTestLib из Qt 5.4 или более ранних версий, вам необходимо продолжать использовать специализацию.

Примечание: Вызывающая сторона toString() должна удалить возвращённые данные, используя delete[]. Ваша реализация должна возвращать строку, созданную с помощью new[] или qstrdup(). Самый простой способ сделать это — создать QByteArray или QString и вызвать QTest::toString() на нём (см. второй пример ниже).

Пример специализации (Qt ≤ 5.4):

namespace QTest {
    template<>
    char *toString(const MyPoint &point)
    {
        QByteArray ba = "MyPoint(";
        ba += QByteArray::number(point.x()) + ", " + QByteArray::number(point.y());
        ba += ')';
        return qstrdup(ba.data());
    }
}

Приведённый выше пример определяет специализацию toString() для класса с именем MyPoint. Всякий раз, когда сравнение двух экземпляров MyPoint терпит неудачу, QCOMPARE() будет вызывать эту функцию для вывода содержимого MyPoint в журнал тестирования.

Тот же пример, но с перегрузкой (Qt ≥ 5.5):

namespace MyNamespace {
    char *toString(const MyPoint &point)
    {
        // bring QTest::toString overloads into scope:
        using QTest::toString;
        // delegate char* handling to QTest::toString(QByteArray):
        return toString("MyPoint(" +
                        QByteArray::number(point.x()) + ", " +
                        QByteArray::number(point.y()) + ')');
    }
}

См. также QCOMPARE().

QTouchEventSequence QTest::touchEvent(QWidget *widget, QTouchDevice *device, bool autoCommit = true)

Создаёт и возвращает QTouchEventSequence для device для имитации событий для widget.

При добавлении касательных событий в последовательность widget также будет использоваться для преобразования предоставленных координат в экранные, если в соответствующих вызовах press(), move() и т.д. не указан другой виджет.

Касательные события передаются в систему событий при вызове деструктора QTouchEventSequence (т.е. когда объект выходит из области видимости), если autoCommit не установлено в false. Если autoCommit равно false, commit() необходимо вызвать вручную.

QTouchEventSequence QTest::touchEvent(QWindow *window, QTouchDevice *device, bool autoCommit = true)

Создаёт и возвращает QTouchEventSequence для device для имитации событий для window.

При добавлении касательных событий в последовательность window также будет использоваться для преобразования предоставленных координат в экранные, если в соответствующих вызовах press(), move() и т.д. не указано другое окно.

Эта функция была добавлена в Qt 5.0.

void TestBenchmark::simple()
{
    QString str1 = QLatin1String("This is a test string");
    QString str2 = QLatin1String("This is a test string");

    QCOMPARE(str1.localeAwareCompare(str2), 0);

    QBENCHMARK {
        str1.localeAwareCompare(str2);
    }
}

QCOMPARE(QString("hello").toUpper(), QString("HELLO"));

QEXPECT_FAIL("", "Will fix in the next release", Continue);
QCOMPARE(i, 42);
QCOMPARE(j, 43);

QEXPECT_FAIL("data27", "Oh my, this is soooo broken", Abort);
QCOMPARE(i, 42);

if (sizeof(int) != 4)
    QFAIL("This test has not been ported to this platform yet.");

void TestQString::toInt_data()
{
    QTest::addColumn<QString>("aString");
    QTest::addColumn<int>("expected");

    QTest::newRow("positive value") << "42" << 42;
    QTest::newRow("negative value") << "-42" << -42;
    QTest::newRow("zero") << "0" << 0;
}

void TestQString::toInt()
{
     QFETCH(QString, aString);
     QFETCH(int, expected);

     QCOMPARE(aString.toInt(), expected);
}

// Source: /home/user/sources/myxmlparser/tests/tst_myxmlparser/tst_myxmlparser.cpp
// Build:  /home/user/build/myxmlparser/tests/tst_myxmlparser
// Qt:     /usr/local/Qt-5.0.0
void tst_MyXmlParser::parse()
{
    MyXmlParser parser;
    QString input = QFINDTESTDATA("testxml/simple1.xml");
    QVERIFY(parser.parse(input));
}

if (!QSqlDatabase::drivers().contains("SQLITE"))
    QSKIP("This test requires the SQLITE database driver");

QFETCH(QString, myString);
QCOMPARE(QString("hello").toUpper(), myString);

QTEST(QString("hello").toUpper(), "myString");

class TestQString: public QObject { ... };
QTEST_MAIN(TestQString)

QTRY_VERIFY2_WITH_TIMEOUT(list.size() > 2, QByteArray::number(list.size()).constData());

QTRY_VERIFY2_WITH_TIMEOUT(list.size() > 2, QByteArray::number(list.size()).constData(), 10000);

QVERIFY2(1 + 1 == 2, "A breach in basic arithmetic occurred.");

QVERIFY(1 + 1 == 2);