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

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

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

Классы

Типы

Функции

Макросы

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

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

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

enum QTest::AttributeIndex

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

enum QTest::KeyAction

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

enum QTest::LogElementType

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

enum QTest::MouseAction

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

enum 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 = ...)

Добавляет столбец типа 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().

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

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

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

QTestData &QTest::addRow(const char *format, ...)

Добавляет новую строку в текущие данные теста. Аргументы функции передаются в qsnprintf() для форматирования в соответствии с format. См. документацию qvsnprintf() для замечаний и ограничений.

Отформатированная строка будет отображаться как имя этих тестовых данных в выводе теста.

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

Пример:

void myTestFunction_data()
{
    QTest::addColumn<int>("input");
    QTest::addColumn<QString>("output");
    QTest::addRow("%d", 0) << 0 << QString("0");
    QTest::addRow("%d", 1) << 1 << QString("1");
}

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

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

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

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

const char *QTest::benchmarkMetricName(QTest::QBenchmarkMetric metric)

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

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

const char *QTest::benchmarkMetricUnit(QTest::QBenchmarkMetric metric)

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

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

QTouchDevice *QTest::createTouchDevice(QTouchDevice::DeviceType devType = ...)

Создаёт виртуальное устройство касания типа devType для моделирования событий касания.

Устройство касания будет зарегистрировано в интерфейсе системы окон QPA и удалено автоматически при удалении QCoreApplication. Поэтому обычно используйте createTouchDevice() для инициализации переменной-члена QTouchDevice в вашем классе тестового случая и используйте один и тот же экземпляр для всех тестов.

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

См. также QTest::QTouchEventSequence.

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.

void QTest::keyClick(QWidget *widget, Qt::Key key, Qt::KeyboardModifiers modifier = ..., int delay = ...)

Имитирует нажатие 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().

void QTest::keyClick(QWindow *window, Qt::Key key, Qt::KeyboardModifiers modifier = ..., int delay = ...)

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

Имитирует нажатие 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().

void QTest::keyClick(QWindow *window, char key, Qt::KeyboardModifiers modifier = ..., int delay = ...)

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

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

Пример:

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

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

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

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

void QTest::keyClick(QWidget *widget, char key, Qt::KeyboardModifiers modifier = ..., int delay = ...)

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

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

Пример:

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

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

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

void QTest::keyClicks(QWidget *widget, const QString &sequence, Qt::KeyboardModifiers modifier = ..., int delay = ...)

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

Пример:

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

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

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

void QTest::keyEvent(QTest::KeyAction action, QWidget *widget, Qt::Key key, Qt::KeyboardModifiers modifier = ..., int delay = ...)

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

void QTest::keyEvent(QTest::KeyAction action, QWindow *window, char ascii, Qt::KeyboardModifiers modifier = ..., int delay = ...)

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

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

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

void QTest::keyEvent(QTest::KeyAction action, QWindow *window, Qt::Key key, Qt::KeyboardModifiers modifier = ..., int delay = ...)

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

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

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

void QTest::keyEvent(QTest::KeyAction action, QWidget *widget, char ascii, Qt::KeyboardModifiers modifier = ..., int delay = ...)

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

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

void QTest::keyPress(QWidget *widget, Qt::Key key, Qt::KeyboardModifiers modifier = ..., int delay = ...)

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

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

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

void QTest::keyPress(QWindow *window, char key, Qt::KeyboardModifiers modifier = ..., int delay = ...)

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

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

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

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

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

void QTest::keyPress(QWindow *window, Qt::Key key, Qt::KeyboardModifiers modifier = ..., int delay = ...)

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

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

Примечание: В какой-то момент вы должны отпустить клавишу с помощью keyRelease().

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

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

void QTest::keyPress(QWidget *widget, char key, Qt::KeyboardModifiers modifier = ..., int delay = ...)

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

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

Примечание: В какой-то момент вы должны отпустить клавишу с помощью keyRelease().

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

void QTest::keyRelease(QWidget *widget, Qt::Key key, Qt::KeyboardModifiers modifier = ..., int delay = ...)

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

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

void QTest::keyRelease(QWindow *window, char key, Qt::KeyboardModifiers modifier = ..., int delay = ...)

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

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

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

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

void QTest::keyRelease(QWindow *window, Qt::Key key, Qt::KeyboardModifiers modifier = ..., int delay = ...)

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

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

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

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

void QTest::keyRelease(QWidget *widget, char key, Qt::KeyboardModifiers modifier = ..., int delay = ...)

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

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

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

void QTest::keySequence(QWindow *window, const QKeySequence &keySequence)

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

Имитирует ввод keySequence в window.

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

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

void QTest::keySequence(QWidget *widget, const QKeySequence &keySequence)

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

Имитирует ввод keySequence в widget.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Имитирует отпускание кнопки мыши 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 = 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**), но вместо списка char** принимает QStringList аргументов arguments.

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

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

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

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

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

void QTest::qSleep(int ms)

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

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

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

Пример:

QTest::qSleep(250);

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

void QTest::qWait(int ms)

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

Пример:

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

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

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

bool QTest::qWaitFor(Functor predicate, int timeout = 5000)

Ожидает timeout миллисекунд или пока predicate не вернёт true.

Возвращает true, если predicate вернуло true в какой-то момент, в противном случае возвращает false.

Пример:

    MyObject obj;
    obj.startup();
    QTest::qWaitFor([&]() {
        return obj.isReady();
    }, 3000);

Вышеприведённый код будет ожидать готовности объекта в течение максимум трёх секунд.

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

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

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

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

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

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

bool QTest::qWaitForWindowActive(QWidget *widget, int timeout = 5000)

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

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

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

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

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

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

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

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

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

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

bool QTest::qWaitForWindowExposed(QWidget *widget, int timeout = 5000)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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().

char *QTest::toString(const QPair<T1, T2> &pair)

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

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

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

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

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

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

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

char *QTest::toString(QSizePolicy sp)

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

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

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

char *QTest::toString(const std::pair<T1, T2> &pair)

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

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

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

char *QTest::toString(const std::tuple<Types...> &tuple)

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

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

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

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

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

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

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

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

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

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

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 QCborError &c)

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

Возвращает текстовое представление заданной ошибки CBOR c.

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

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 QUuid &uuid)

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

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

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

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

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

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

char *QTest::toString(std::nullptr_t)

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

Возвращает строку, содержащую nullptr.

Этот метод был введён в Qt 5.8.

char *QTest::toString(const QVector2D &v)

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

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

Этот метод был введён в Qt 5.11.

char *QTest::toString(const QVector3D &v)

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

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

Этот метод был введён в Qt 5.11.

char *QTest::toString(const QVector4D &v)

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

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

Этот метод был введён в Qt 5.11.

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

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

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

Этот метод был введён в Qt 5.5.

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

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

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

Этот метод был введён в Qt 5.5.

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

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

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

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

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

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

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

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

Этот метод был введён в 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);