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

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

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

Классы

Типы

Функции

Макросы

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

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

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

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

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

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

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

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

Перечисление указывает виды сообщений журналов тестов.

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

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

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

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

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

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

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

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

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

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

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

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

Добавляет столбец типа 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(). Если сообщение с соответствующим типом выводится, оно будет удалено из журнала теста. Если тест завершился и сообщение не выводилось, в журнал теста будет добавлено сообщение об ошибке теста.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Имитирует отпускание кнопки мыши button с необязательным модификатором stateKey на окне window. Позиция отпускания определяется 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**) , но принимает QStringList аргументов arguments вместо char** списка.

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

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

Конкретная конфигурация, в которой это происходит, — использование 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 как последовательность шестнадцатеричных символов, разделённых пробелами. Если входная строка слишком длинная, она усекается. Об усечении в возвращаемой строке свидетельствует эллипсис в конце. Вызывающий код владеет возвращенным указателем и должен гарантировать, что он будет позже передан в operator 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::ControlTypes cts)

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

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

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

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

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

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

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

char *QTest::toString(QSizePolicy sp)

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

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

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

char *QTest::toString(const 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.

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

char *QTest::toString(const QUuid &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.

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

namespace QTest {
    template <> char *toString<MyType>(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);
}

void TestQLocale::roundTripInt_data()
{
    QTest::addColumn<int>("number");
    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);
}

// 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(qIsNaN(0.0 / 0.0), "Ill-defined division produced unambiguous result.");

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