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

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

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

Классы

Типы

Функции

Макросы

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

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

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

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

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

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

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

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

Это перечисление перечисляет все, что можно измерить.

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

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

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

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

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

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

шаблон <typename T> void QTest::addColumn(const char *name, T *dummy = 0)

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

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

Пример:

    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.

[since 5.9] QTestData &QTest::addRow(const char *format, ...)

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

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

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

Пример:

    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 в виде строкового представления.

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

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

[since 5.8] QPointingDevice *QTest::createTouchDevice(QInputDevice::DeviceType devType = QInputDevice::DeviceType::TouchScreen, QInputDevice::Capabilities caps = QInputDevice::Capability::Position)

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

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

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

См. также QTest::QTouchEventSequence и touchEvent().

const char *QTest::currentAppName()

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

const char *QTest::currentDataTag()

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

bool QTest::currentTestFailed()

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

const char *QTest::currentTestFunction()

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

Пример:

void MyTestClass::cleanup()
{
    if (qstrcmp(QTest::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() выводит правильное предупреждение при вызове с недопустимым именем файла.

[since 5.3] 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 = 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().

[since 5.0] 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().

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

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

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

Пример:

QWidget myWindow;
QTest::keyClick(&myWindow, Qt::Key_Tab);

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

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

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

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

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

Эмулирует нажатие последовательности клавиш 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 = Qt::NoModifier, int delay = -1)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

[since 5.0] 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().

[since 5.0] 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().

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

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

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

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

[since 5.10] void QTest::keySequence(QWindow *window, const QKeySequence &keySequence)

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

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

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

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

[since 5.10] 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 = Qt::KeyboardModifiers(), QPoint pos = QPoint(), int delay = -1)

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

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

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

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

Имитирует нажатие кнопки мыши button с необязательным модификатором stateKey на window. Позиция щелчка определяется pos; по умолчанию это центр window. Если задано 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)

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

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

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

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

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

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

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

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

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

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

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

Перемещает указатель мыши на window. Если pos не указан, указатель мыши перемещается в центр window. Если задано 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 на widget. Позиция определяется pos; по умолчанию - центр виджета. Если указан delay, тест будет ожидать заданное количество миллисекунд перед нажатием.

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

[since 5.0] void QTest::mousePress(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::mouseRelease() и QTest::mouseClick().

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

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

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

[since 5.0] void QTest::mouseRelease(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::mouseClick().

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

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

Пример:

void MyTestClass::addSingleStringRows()
{
    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 &), поскольку она безопасна для Юникода.

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

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

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

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

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

[since 5.10] template <typename Functor> 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.

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

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

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

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

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

[since 5.0] bool QTest::qWaitForWindowActive(QWidget *widget, int timeout = 5000)

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

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

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

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

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

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

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

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

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

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

[since 5.0] 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.

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

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

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

[since 5.11] char *QTest::toString(const QStringView &string)

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

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

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

template <typename T> char *QTest::toString(const T &value)

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

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

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

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

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

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

namespace {
    char *toString(const MyPoint &point)
    {
        return QTest::toString("MyPoint(" +
                               QByteArray::number(point.x()) + ", " +
                               QByteArray::number(point.y()) + ')');
    }
}

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

[since 5.11] template <typename T1, typename T2> char *QTest::toString(const QPair<T1, T2> &pair)

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

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

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

[since 5.11] char *QTest::toString(const QVector2D &v)

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

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

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

[since 5.11] char *QTest::toString(const QVector3D &v)

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

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

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

[since 5.11] char *QTest::toString(const QVector4D &v)

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

Возвращает текстовое представление четырёхмерного вектора v.

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

[since 5.5] char *QTest::toString(QSizePolicy::Policy p)

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

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

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

[since 5.5] char *QTest::toString(QSizePolicy::ControlTypes cts)

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

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

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

[since 5.5] char *QTest::toString(QSizePolicy::ControlType ct)

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

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

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

[since 5.5] char *QTest::toString(QSizePolicy sp)

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

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

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

[since 5.11] template <typename T1, typename T2> char *QTest::toString(const std::pair<T1, T2> &pair)

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

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

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

[since 5.12] template <typename Types> char *QTest::toString(const std::tuple<Types...> &tuple)

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

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

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

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.

[since 5.12] 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.

[since 5.11] char *QTest::toString(const QUuid &uuid)

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

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

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

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

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

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

[since 5.8] char *QTest::toString(std::nullptr_t)

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

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

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

QTest::QTouchEventWidgetSequence QTest::touchEvent(QWidget *widget, QPointingDevice *device, bool autoCommit = true)

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

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

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

createTouchDevice() можно вызвать для создания тестового устройства касания для использования с этой функцией.

[since 5.0] QTest::QTouchEventSequence QTest::touchEvent(QWindow *window, QPointingDevice *device, bool autoCommit = true)

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

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

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

createTouchDevice() можно вызвать для создания тестового устройства касания для использования с этой функцией.

Эта функция была добавлена в 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"));

    const int expected[] = {8, 10, 12, 16, 20, 24};
    QCOMPARE(QFontDatabase::standardSizes(), expected);

 #define ARG(...) __VA_ARGS__
     QCOMPARE(QFontDatabase::standardSizes(), ARG({8, 10, 12, 16, 20, 24}));
 #undef ARG

char *toString(const MyType &t)
{
    char *repr = new char[t.reprSize()];
    t.writeRepr(repr);
    return repr;
}

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);
}

void TestQLocale::initTestCase_data()
{
    QTest::addColumn<QLocale>("locale");
    QTest::newRow("C") << QLocale::c();
    QTest::newRow("UKish") << QLocale("en_GB");
    QTest::newRow("USAish") << QLocale(QLocale::English, QLocale::UnitedStates);
}

void TestQLocale::roundTripInt_data()
{
    QTest::addColumn<int>("number");
    QTest::newRow("zero") << 0;
    QTest::newRow("one") << 1;
    QTest::newRow("two") << 2;
    QTest::newRow("ten") << 10;
}

void TestQLocale::roundTripInt()
{
    QFETCH_GLOBAL(QLocale, locale);
    QFETCH(int, number);
    bool ok;
    QCOMPARE(locale.toInt(locale.toString(number), &ok), number);
    QVERIFY(ok);
}

bool 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");

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(QFileInfo("file.txt").exists(), "file.txt does not exist.");

bool opened = file.open(QIODevice::WriteOnly);
QVERIFY(opened);

QVERIFY2(file.open(QIODevice::WriteOnly),
         qPrintable(QString("open %1: %2")
                    .arg(file.fileName()).arg(file.errorString())));

QVERIFY(spy.isValid());