Пространство имён 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.

См. также 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().

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

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

См. также 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");

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

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

Эта функция была добавлена в 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(). Если сообщение message соответствующего типа type выводится, оно будет удалено из протокола тестирования. Если тестирование завершено, а сообщение message не было выведено, в протокол тестирования будет добавлено сообщение об ошибке.

Примечание: Вызов этой функции игнорирует только одно сообщение. Если необходимо игнорировать сообщение, выведенное дважды, необходимо дважды вызвать функцию 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. Необязательно, можно указать модификатор клавиатуры modifier и задержку delay (в миллисекундах) теста перед каждым нажатием клавиши.

Пример:

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 на widget с заданной key и соответствующим action. Необязательно, можно указать модификатор клавиатуры modifier, а также delay (в миллисекундах) теста перед отправкой события.

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

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

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

Функция была введена в 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 на window с заданной key и соответствующим action. Необязательно, можно указать модификатор клавиатуры modifier, а также delay (в миллисекундах) теста перед отправкой события.

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

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

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

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

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

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

[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 миллисекунд перед нажатием клавиши.

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

Этот метод был введён в 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 миллисекунд перед нажатием клавиши.

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

См. также 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; по умолчанию это центр виджета. Если указан 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; по умолчанию это центр окна. Если указан 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; по умолчанию это центр виджета. Если указан 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; по умолчанию это центр окна. Если указан delay, тест подождёт указанное количество миллисекунд перед каждым нажатием и отпусканием кнопки.

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

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

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

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

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

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

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

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

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

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

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

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 миллисекунд, в противном случае возвращает window.

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

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

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

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

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

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

Это полезно в основном для асинхронных систем, таких как 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.

template <typename T> 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)
    {
        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.

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

[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 url.

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

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

Возвращает текстовое представление заданного 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());