CAPL Script

lookupSignal

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

signal * lookupSignal(char signalName[]);

Function

Searches for a signal in the database(s). If the 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 invalidsignal.

Parameters

signalName The qualified name of the signal. The syntax is[Channel::][Database name (alias)::][Node::][Message::]Signa; the order and completeness of the objects from right to left is important. See the example forgetSignal(char signalName[]).

Return Values

The found unique signal or an invalid object.

—