Main Content

sltest.harness.find

Find test harnesses in model

Description

example

harnessList = sltest.harness.find(harnessOwner) returns a structure listing harnesses and harness properties that exist for the component or model harnessOwner.

harnessList = sltest.harness.find(harnessOwner,Name,Value) uses additional search options specified by one or more Name,Value pair arguments.

Examples

collapse all

Find harnesses for the f14 model and its first-level subsystems. The function matches harness names according to a regular expression.

openExample('f14');
sltest.harness.create('f14','Name','model_harness');
sltest.harness.create('f14/Controller','Name',...
   'Controller_Harness1');
harnessList = sltest.harness.find('f14',...
   'SearchDepth',1,'Name','_[Hh]arnes+',...
   'RegExp','on')
harnessList = 

1x2 struct array with fields:

    model
    name
    description
    type
    ownerHandle
    ownerFullPath
    ownerType
    isOpen
    canBeOpened
    verificationMode
    saveExternally
    rebuildOnOpen
    rebuildModelData
    graphical
    origSrc
    origSink

Input Arguments

collapse all

Model or component handle or path, specified as a character vector or double

Example: 1.9500e+03

Example: 'model_name'

Example: 'model_name/Subsystem'

Name-Value Arguments

Specify optional pairs of arguments as Name1=Value1,...,NameN=ValueN, where Name is the argument name and Value is the corresponding value. Name-value arguments must appear after other arguments, but the order of the pairs does not matter.

Before R2021a, use commas to separate each name and value, and enclose Name in quotes.

Example: 'SearchDepth',2,'Name','controller_harness' searches the model or component, and two lower hierarchy levels, for harnesses named controller_harness.

Harness name to search for in the model, specified as the comma-separated pair consisting of 'Name' and a character vector or a regular expression. You can specify a regular expression only if you also use the Name,Value pair 'RegExp','on'.

Example: 'Name','sample_harness''Name','_[Hh]arnes+'

Ability to search using a regular expression, specified as the comma-separated pair consisting of 'RegExp' and 'off' or 'on'. When 'RegExp' is set to 'on', you can use a regular expression with 'Name'.

Example: 'RegExp','on'

Subsystem levels into harnessOwner to search for harnesses, specified as the comma-separated pair consisting of 'SearchDepth' and an integer. For example:

0 searches harnessOwner.

1 searches harnessOwner and its subsystems.

2 searches harnessOwner, its subsystems, and their subsystems.

When you do not specify SearchDepth, the function searches all levels of harnessOwner.

Example: 'SearchDepth',1

Search option to return only open or loaded harnesses, specified as the comma-separated pair consisting of 'OpenOnly' and 'off' or 'on'.

Example: 'OpenOnly','on'

Name of the function interface for the reusable library subsystem to search for, specified as a string or character vector. Using this Name-Value pair returns a list of all harnesses for the specified function interface.

Example: 'FunctionInterfaceName','double_RLS'

Output Arguments

collapse all

List of harnesses and properties for the component or model harnessOwner, returned as a structure. The structure fields are shown in the Use RegExp to Find Harnesses for a Model Component example.

Version History

Introduced in R2015a