verifySameHandle

Класс: matlab.unittest.qualifications.
Пакет: matlab.unittest.qualifications

Проверьте, что два значения являются указателями на тот же экземпляр

Синтаксис

verifySameHandle(verifiable,actual,expectedHandle)
verifySameHandle(___,diagnostic)

Описание

verifySameHandle(verifiable,actual,expectedHandle) проверяет, что actual одного размера и содержит те же экземпляры как массив указателя expectedHandle.

verifySameHandle(___,diagnostic) также отображает диагностическую информацию в diagnostic после отказа.

Входные параметры

verifiable

"Образец matlab.unittest.TestCase, который используется для прохождения или непрохождения проверки типа ""verification"" в сочетании с тестовой средой.".

actual

Значение для проверки.

expectedHandle

Ожидаемый массив указателя.

diagnostic

Диагностическая информация, относящаяся к проверке, указывается как одно из следующего:

  • stringArray

  • массив символов

  • указатель на функцию

  • объект matlab.unittest.diagnostics.Diagnostic

Значения диагностики могут быть нескалярными. Для получения дополнительной информации см. Matlab.unittest.diagnostics.Diagnostic.

Примеры

развернуть все

Создайте объект TestCase для интерактивного тестирования.

testCase = matlab.unittest.TestCase.forInteractiveUse;

Создайте класс Handle, ExampleHandle.

classdef ExampleHandle < handle
end

Создайте две переменные указателя.

h1 = ExampleHandle;
h2 = ExampleHandle;

Покажите соответствие с комбинациями указателя.

verifySameHandle(testCase, h1, h1);
Interactive verification passed.
verifySameHandle(testCase, [h1 h1], [h1 h1]);
Interactive verification passed.
verifySameHandle(testCase, [h1 h2 h1], [h1 h2 h1]);
Interactive verification passed.

Указатели должны указать на тот же объект.

verifySameHandle(testCase, h1, h2);
Interactive verification failed.

---------------------
Framework Diagnostic:
---------------------
verifySameHandle failed.
--> Values do not refer to the same handle.

Actual Value:
      ExampleHandle with no properties.
Expected Handle Object:
      ExampleHandle with no properties.

Не удалось выполнить тест.

Размер объектов указателя должен соответствовать.

verifySameHandle(testCase, [h1 h1], h1);
Interactive verification failed.

---------------------
Framework Diagnostic:
---------------------
verifySameHandle failed.
--> Sizes do not match.
    	Actual Value Size           : [1  2]
    	Expected Handle Object Size : [1  1]

Actual Value:
      1x2 ExampleHandle array with no properties.
Expected Handle Object:
      ExampleHandle with no properties.

Не удалось выполнить тест.

Порядок аргументов важен.

verifySameHandle(testCase, [h1 h2], [h2 h1]);
Interactive verification failed.

---------------------
Framework Diagnostic:
---------------------
verifySameHandle failed.
--> Some elements in the handle array refer to the wrong handle.

Actual Value:
      1x2 ExampleHandle array with no properties.
Expected Handle Object:
      1x2 ExampleHandle array with no properties.

Не удалось выполнить тест.

Советы

  • Этот метод функционально эквивалентен:

    import matlab.unittest.constraints.IsSameHandleAs;
    verifiable.verifyThat(actual, IsSameHandleAs(expectedHandle));

    Там существует больше функциональности при использовании ограничения IsSameHandleAs непосредственно через verifyThat.

  • Используйте проверку типа "verification" для создания и записи сбоев без выдачи исключения. Поскольку проверки не выдают исключения, все тесты выполняются до своего завершения, даже когда имеют место сбои в проверке. Как правило, проверки типа "verification" являются основой для модульного теста, поскольку они обычно не требуют раннего выхода из тестирования. Используйте другие типы проверки для выявления нарушений предварительных обязательных условий или неправильной настройки теста. В качестве варианта,

    • Используйте проверку типа "assumption", чтобы убедиться, что тестовая среда соответствует предварительным обязательным условиям, которые не приводят к ошибке тестирования. Нарушение условий приводит к фильтрации тестов, а среда тестирования помечает тесты как незавершенные. Для получения дополнительной информации см. matlab.unittest.qualifications. Assumable.

    • Используйте проверку типа "assertion", когда состояние отказа делает недействительным оставшуюся часть текущего теста, но не препятствует правильному выполнению последующих видов тестирования. Сбой в точке утверждения показывает, что текущий метод тестирования является неудачным и неполным. Для получения дополнительной информации см. matlab.unittest.qualifications. Assertable.

    • Используйте проверку типа "fatal assertion", чтобы прервать сеанс тестирования после сбоя. Эти типы проверки применяются, когда характер отказа настолько принципиален, что нет смысла продолжать тестирование. Эти виды проверки также применяются, когда отключение без изменений не восстанавливает состояние MATLAB® правильно, и лучше прекратить тестирование и начать новый сеанс. Для получения дополнительной информации см. matlab.unittest.qualifications. FatalAssertable.

Введенный в R2013a

Для просмотра документации необходимо авторизоваться на сайте