Reactis for C API:
General Reactis for C Functions

rcOpen

Start a Reactis for C API session.

Syntax

rcOpen

Description

rcOpen loads and initializes the Reactis for C API.

See Also

rcClose

rcClose

End a Reactis for C API session.

Syntax

rcClose

Description

rcClose removes the Reactis for C API library and all associated files from MATLAB memory. All currently open .rsm and .rsh files, Tester or Simulator sessions will be closed without saving.

See Also

rcGetCoverageMetrics

Get coverage information from the most recent test run.

Syntax

metrics = rcGetCoverageMetrics 

Description

metrics = rcGetCoverageMetrics returns coverage information as the result of the most recent call to rcSimRunSuite, rcTester, or rcTesterStart.

metrics is a structure array containing one element for each coverage metric tracked by Reactis. The structure contains the following fields:

name

Name of the coverage metric.

numTargets

Total number of coverage targets in this metric.

numCovered

Number of covered targets for this metric.

numUncovered

Number of uncovered targets for this metric.

numUnreachable

Number of unreachable targets for this metric.

percentCovered

Coverage percentage for this metric.

See Also

rcGetParameterValue

Get the value of a global Reactis for C parameter.

Syntax

value = rcGetParameterValue(paramName)

Description

value = rcGetParameterValue(paramName) returns the value of global Reactis for C parameter paramName.

Parameters of any data type may be queried by rcGetParameterValue. The return value is always a string.

Valid parameters names are listed in the Reactis Parameters section of the API chapter in the Reactis for C User's Guide.

Examples

v = rcGetParameterValue('UserName');

See Also

rcGetParameterValueBool

Get the value of a global boolean typed Reactis for C parameter.

Syntax

value = rcGetParameterValueBool(paramName)

Description

value = rcGetParameterValueBool(paramName) returns the value of global boolean typed Reactis for C parameter paramName.

If the parameter is not of type boolean, then an error is raised.

Valid parameters names are listed in the Reactis Parameters section of the API chapter in the Reactis for C User's Guide.

See Also

rcGetParameterValueDouble

Get the value of a global double typed Reactis for C parameter.

Syntax

value = rcGetParameterValueDouble(paramName)

Description

value = rcGetParameterValueDouble(paramName) returns the value of global double typed Reactis for C parameter paramName.

If the parameter is not of type double, then an error is raised.

Valid parameters names are listed in the Reactis Parameters section of the API chapter in the Reactis for C User's Guide.

See Also

rcSetParameterValue

Set the value of a global Reactis for C parameter.

Syntax

rcSetParameterValue(paramName,value)

Description

rcSetParameterValue(paramName,value) sets global Reactis for C parameter paramName to value.

Parameters of any data type may be set by rcSetParameterValue, but the paramValue argument must be given as a string.

Valid parameters names are listed in the Reactis Parameters section of the API chapter in the Reactis for C User's Guide.

Examples

rcSetParameterValue('LibraryPath', newSearchPath);

See Also

rcSetStringEncoding

Set string encoding.

Syntax

rcSetStringEncoding(encoding)

Description

rcSetStringEncoding(encoding) sets the character encoding for strings returned by functions like rcGetLastError and rcTesterGetStatus. If not set, the strings will be UTF8 encoded.

rcVersion

Return Reactis for C API version.

Syntax

s = rcVersion

Description

s = rcVersion returns the version of the Reactis for C API.

See Also

rcVersionParse

Parse Reactis version string.

Syntax

major,minor,patch = rcVersionParse(version)

Description

major,minor,patch = rcVersionParse(version) parses Reactis version string version (as returned by functions rcVersion or rcSuiteGetReactisVersion) and returns the major version, minor version, and patch number.