Syntax:

@MATCH( <list>, <string> {, EXACT} )

Description:

This function returns 1 (true) if a string in the string list <list>, starting from the current pointer position, contains text matching <string>. The match is not case-sensitive unless the optional parameter EXACT is specified [VDS6].  The parameter <list> must be either a list number or the name of a list dialog element to which the function will apply.

The pointer is advanced to the matching item number, so you can obtain the contents of the string using @ITEM or @NEXT, rewrite it using LIST PUT and obtain the index value using @INDEX.

If no match is found, null (false) is returned and the index value is unchanged.

OK:

Set to false if no match is found.

Example:

LIST CREATE, 1

LIST LOADFILE, 1,NAMES.TXT

%M = @MATCH(1,Jim)

INFO %M

LIST CLOSE, 1

See also: