verifyLength

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

Убедитесь, что значение имеет заданную длину

Синтаксис

verifyLength(verifiable,actual,expectedLength) verifyLength(___,diagnostic)

Описание

verifyLength(verifiable,actual,expectedLength) проверяет, что actual - массив MATLAB ®, длина которого равнаexpectedLength.

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

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

`verifiable`	`matlab.unittest.TestCase` экземпляр, который используется для прохождения или неуспешного завершения проверки в сочетании с тестовой исполняемой платформой.
`actual`	Тестируемое значение.
`expectedLength`	Длина массива определяется как наибольшее измерение этого массива.
`diagnostic`	Диагностическая информация, относящаяся к квалификации, указана как одно из следующих: строковый массив символьный массив дескриптор функции `matlab.unittest.diagnostics.Diagnostic` объект Диагностические значения могут быть нескалярными. Дополнительные сведения см. в разделе `matlab.unittest.diagnostics.Diagnostic`.

Примеры

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

Длина тестового массива

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

testCase = matlab.unittest.TestCase.forInteractiveUse;

Проверьте, что длина массива является ожидаемым значением. 5.

verifyLength(testCase, ones(2, 5, 3), 5, 'User diagnostic');

Interactive verification passed.

Длина массива не является ожидаемым значением, 3.

verifyLength(testCase, [2 3], 3);

Interactive verification failed.

---------------------
Framework Diagnostic:
---------------------
verifyLength failed.
--> The array has an incorrect length.
    
    Actual Length:
             2
    Expected Length:
             3

Actual Array:
         2     3

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

Длина массива 2x3 равна 3.

verifyLength(testCase, [1 2 3; 4 5 6], 3);

Interactive verification passed.

Убедитесь, что длина массива 2x3 не соответствует количеству элементов. 6.

verifyLength(testCase, [1 2 3; 4 5 6], 6);

Interactive verification failed.

---------------------
Framework Diagnostic:
---------------------
verifyLength failed.
--> The array has an incorrect length.
    
    Actual Length:
             3
    Expected Length:
             6

Actual Array:
         1     2     3
         4     5     6

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

verifyLength(testCase, eye(2), 4);

Interactive verification failed.

---------------------
Framework Diagnostic:
---------------------
verifyLength failed.
--> The array has an incorrect length.
    
    Actual Length:
             2
    Expected Length:
             4

Actual Array:
         1     0
         0     1

Длина массива тестовых ячеек

testCase = matlab.unittest.TestCase.forInteractiveUse;
verifyLength(testCase, {'someText', 'someotherText'}, 2);

Interactive verification passed.

Совет

Этот метод функционально эквивалентен:
```
import matlab.unittest.constraints.HasLength;
verifiable.verifyThat(actual, HasLength(expectedLength));
```
Существует больше функциональных возможностей при использовании HasLength ограничение непосредственно через verifyThat.
Используйте условия проверки для создания и записи отказов без создания исключения. Так как проверки не вызывают исключений, все содержимое теста выполняется до завершения даже при возникновении ошибок проверки. Как правило, проверки являются основной квалификацией для единичного теста, поскольку они обычно не требуют раннего выхода из теста. Используйте другие типы квалификации для проверки на нарушение предварительных условий или неправильной настройки теста. В качестве альтернативы,
- Для проверки соответствия среды тестирования предварительным условиям, которые в противном случае не приведут к сбою теста, используйте квалификационные требования. Предполагаемые отказы приводят к отфильтрованным тестам, и платформа тестирования помечает тесты как Incomplete. Дополнительные сведения см. в разделе matlab.unittest.qualifications.Assumable.
- Используйте условия утверждения, когда условие отказа аннулирует остальную часть текущего содержимого теста, но не препятствует надлежащему выполнению последующих методов тестирования. Сбой в точке утверждения делает текущий метод тестирования неуспешным и неполным. Дополнительные сведения см. в разделе matlab.unittest.qualifications.Assertable.
- Используйте условия неустранимого утверждения, чтобы прервать тестовый сеанс при сбое. Эти требования полезны, когда режим отказа настолько фундаментален, что нет смысла продолжать тестирование. Эти требования также полезны, когда отрыв приспособления не восстанавливает состояние MATLAB правильно, и предпочтительно прервать тестирование и начать новую сессию. Дополнительные сведения см. в разделе matlab.unittest.qualifications.FatalAssertable.

См. также

Темы

Таблица проверок, утверждений и других квалификаций

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

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