CAPL Script

lookupServiceSignalString

This reference collection includes Vector documentation reproduced with permission. Snippets may require configuration-specific symbols and are not all standalone programs. Sources and validation limits.

Syntax

serviceSignalString * lookupServiceSignalString(char serviceSignalName[]);

Function

Searches for a SOME/IPService Signalin the database(s). If the Service Signal is not found or if the name is not unique, test modules/units report anerror in test systemwhile simulation/analysis nodes write a warning into the Write Window, and the function returns an invalidserviceSignal. lookupServiceSignalStringcan be used to access a Service Signal, which was specified by a string during measurement. The function makes it possible to write dynamic tests with Service Signals, where the name of the Service Signal is not given at compile time. lookupServiceSignalStringis for Service Signals, which can be represented as string. For data and number types seelookupServiceSignalDataandlookupServiceSignalNumber.

Parameters

serviceSignalName Thequalifier of the Service Signal.

Return Values

The found unique Service Signal or an invalid object.

// set the string of some service-signals to empty data
int i;
char serviceSignalNames[2][70] = {
  "sif_001::TrafficSignDetection::DetectedTrafficSign.Name","sif_2001::TrafficSignDetection::DetectedTrafficSign.Description"
};
char emptyString[8] = "";
for( i = 0; i < elcount(serviceSignalNames); i++ ) {
  serviceSignalString * sig;
  sig = lookupServiceSignalString( serviceSignalNames[i] );
  SetServiceSignalString( sig, emptyString );
}