Syntax

a$ = GetKey(key$, string$)

Description

To search for a keyword and returns its value. This is of use particularly from the Basic Control Engine to extract the EVENT and ACTION, which caused the script to run. An empty string is returned if the key is not found.

Comments

Parameter

Description

key$

String. The keyword to search for.

string$

String. The string to search for the keyword. The format of this string is keyword followed by an equal sign and the value. A comma separates multiple keyword value combinations.

Example

sub main()

   event_id$= GetKey("EVENT", command$)

   action_id$ = GetKey("ACTION", command$)

   ' Name$ will contain PETE after this statement.

   name$ = GetKey("NAME","NAME=PETE,LOCATION=ALBANY")

end sub

CIMPLICITY Extensions to Basic