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

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

Классы

Типы

Функции

Макросы

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Пример:

    QTest::addColumn<int>("intval");
    QTest::addColumn<QString>("str");
    QTest::addColumn<double>("dbl");
    QTest::newRow("row1") << 1 << "hello" << 1.5;

Для добавления пользовательских типов в данные теста, тип необходимо зарегистрировать в QMetaType через Q_DECLARE_METATYPE().

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

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

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

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

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

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

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

Пример:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

const char *QTest::currentAppName()

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

const char *QTest::currentDataTag()

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

bool QTest::currentTestFailed()

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

const char *QTest::currentTestFunction()

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

Пример:

void MyTestClass::cleanup()
{
    if (qstrcmp(QTest::currentTestFunction(), "myDatabaseTest") == 0) {
        // clean up all database connections
        closeAllDatabases();
    }
}

void QTest::ignoreMessage(QtMsgType type, const char *message)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Эмулирует отпускание кнопки мыши с необязательным модификатором stateKey на окне. Позиция отпускания определяется 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** списка.

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

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

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

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

void QTest::qSleep(int ms)

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

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

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

Пример:

QTest::qSleep(250);

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

void QTest::qWait(int ms)

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

Пример:

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

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

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

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

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

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

Пример:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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.

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