Exponenta Banner
exponenta event banner

verifyInstanceOf

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

Проверьте, что значение является объектом указанного типа

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

Синтаксис

verifyInstanceOf(verifiable,actual,className)
verifyInstanceOf(verifiable,actual,metaClass)
verifyInstanceOf(___,diagnostic)

Описание

verifyInstanceOf(verifiable,actual,className) проверяет, что actual - значение MATLAB ®, класс которого является классом, указанным className.

verifyInstanceOf(verifiable,actual,metaClass) проверяет, что actual - значение MATLAB, класс которого является классом, указанным meta.class случай metaClass.

verifyInstanceOf(___,diagnostic) также связывает диагностическую информацию в diagnostic с квалификацией. В зависимости от конфигурации тестового питателя платформа тестирования может отображать диагностику при прохождении или сбое квалификации. По умолчанию инфраструктура отображает диагностику только при сбое квалификации. Поведение по умолчанию можно переопределить, настроив тестовый питатель. Например, используйте DiagnosticsOutputPlugin для отображения диагностики сбоев и прохождения событий.

Входные аргументы

verifiable

matlab.unittest.TestCase экземпляр, который используется для прохождения или неуспешного завершения проверки в сочетании с тестовой исполняемой платформой.

actual

Тестируемое значение.

className

Имя класса, указанное как символьный вектор.

metaClass

Экземпляр meta.class.

diagnostic

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

  • строковый массив

  • символьный массив

  • дескриптор функции

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

Диагностические значения могут быть нескалярными. Дополнительные сведения см. в разделе matlab.unittest.diagnostics.Diagnostic.

Примеры

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

Эти интерактивные тесты проверяют класс номера, 5.

Создать TestCase и тестируемое значение.

testCase = matlab.unittest.TestCase.forInteractiveUse;
actvalue = 5;

Проверить actvalue является экземпляром класса double.

verifyInstanceOf(testCase, actvalue, 'double');
Interactive verification passed.

Проверить, actvalue является экземпляром char.

verifyInstanceOf(testCase, 5, 'char');
Interactive verification failed.

---------------------
Framework Diagnostic:
---------------------
verifyInstanceOf failed.
--> The value must be an instance of the expected type.
    
    Actual Class:
        double
    Expected Type:
        char

Actual Value:
         5

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

Эти тесты проверяют дескрипторы функций, указанные как экземпляр meta.class, ?function_handle.

Создайте дескриптор функции.

fh = @sin;
testCase = matlab.unittest.TestCase.forInteractiveUse;
verifyInstanceOf(testCase, fh, ?function_handle);

Interactive verification passed.

Проверьте имя функции.

fh = 'sin';
verifyInstanceOf(testCase, fh, ?function_handle);

Interactive verification failed.

---------------------
Framework Diagnostic:
---------------------
verifyInstanceOf failed.
--> The value must be an instance of the expected type.
    
    Actual Class:
        char
    Expected Type:
        function_handle

Actual Value:
    sin

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

Убедитесь, что производный класс не совпадает с базовым.

Создание класса, BaseExample.

classdef BaseExample
end

Создание производного класса, DerivedExample.

classdef DerivedExample < BaseExample
end

Проверить DerivedExample является экземпляром BaseExample.

testCase = matlab.unittest.TestCase.forInteractiveUse;
testCase.verifyInstanceOf(DerivedExample(), ?BaseExample);

Interactive verification passed.

Проверить BaseExample не является экземпляром DerivedExample.

testCase.verifyInstanceOf(BaseExample(), ?DerivedExample);

Interactive verification failed.

---------------------
Framework Diagnostic:
---------------------
verifyInstanceOf failed.
--> The value must be an instance of the expected type.
    
    Actual Class:
        BaseExample
    Expected Type:
        DerivedExample

Actual Value:
      BaseExample with no properties.

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

Совет

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

    import matlab.unittest.constraints.IsInstanceOf;
verifiable.verifyThat(actual, IsInstanceOf(className));
verifiable.verifyThat(actual, IsInstanceOf(metaClass));

    Существует больше функциональных возможностей при использовании IsInstanceOf ограничение непосредственно через verifyThat.

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

    • Для проверки соответствия среды тестирования предварительным условиям, которые в противном случае не приведут к сбою теста, используйте квалификационные требования. Предполагаемые отказы приводят к отфильтрованным тестам, и платформа тестирования помечает тесты как Incomplete. Дополнительные сведения см. в разделе matlab.unittest.qualifications.Assumable.

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

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

См. также

| | | | | |

Темы

Представлен в R2013a

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

Поддержка