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

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

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

Классы

Типы

Функции

Макросы

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

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

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

enum QTest::AttributeIndex

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

enum QTest::KeyAction

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

enum QTest::LogElementType

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

enum QTest::MouseAction

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

enum QTest::QBenchmarkMetric

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

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

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

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

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 в виде строки.

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

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

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

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

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

Создаёт виртуальное устройство ввода касания типа 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(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() выводит правильное предупреждение при вызове с недопустимым именем файла.

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

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

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

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.

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

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

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

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

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

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

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

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

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

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

void QTest::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().

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 = 0, QPoint pos = QPoint(), int delay = -1)

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

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

void QTest::mouseClick(QWindow *window, Qt::MouseButton button, Qt::KeyboardModifiers stateKey = 0, 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 = 0, QPoint pos = QPoint(), int delay = -1)

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

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

void QTest::mouseDClick(QWindow *window, Qt::MouseButton button, Qt::KeyboardModifiers stateKey = 0, 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 (в миллисекундах), тест подождёт перед перемещением указателя мыши.

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 = 0, QPoint pos = QPoint(), int delay = -1)

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

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

void QTest::mousePress(QWindow *window, Qt::MouseButton button, Qt::KeyboardModifiers stateKey = 0, 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 = 0, QPoint pos = QPoint(), int delay = -1)

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

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

void QTest::mouseRelease(QWindow *window, Qt::MouseButton button, Qt::KeyboardModifiers stateKey = 0, 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 &), так как она безопасна для 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().

template <typename Functor> bool QTest::qWaitFor(Functor predicate, int timeout = 5000)

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

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

Пример:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

template <typename T1, typename T2> 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.

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

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

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

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

template <typename Types> 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)

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

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

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

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

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

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

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

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

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

Возвращает текстовое представление четырёхмерного вектора 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"));

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