INLIST (return entry in list)

Top  Previous  Next

 

INLIST(searchstring,liststring,liststring [,liststring...])

INLIST

Returns item in a list.

searchstring

A constant, variable, or expression that contains the value for which to search. If the value is numeric, it is converted to a string before comparisons are made.

liststring

The label of a variable or constant value to compare against the searchstring. If the value is numeric, it is converted to a string before comparisons are made. There may be up to 25 liststring parameters, and there must be at least two.

The INLIST procedure compares the contents of the searchstring against the values contained in each liststring parameter. If a matching value is found, the procedure returns the number of the first liststring parameter containing the matching value (relative to the first liststring parameter). If the searchstring is not found in any liststring parameter, INLIST returns zero.

Return Data Type:

LONG

Example:

INLIST('D','A','B','C','D','E') !returns 4

INLIST('B','A','B','C','D','E') !returns 2

 

EXECUTE INLIST(Emp:Status,'Fulltime','Parttime','Retired','Consultant')

 Scr:Message = 'All Benefits'        !Full timer

 Scr:Message = 'Holidays Only'       !Part timer

 Scr:Message = 'Medical/Dental Only' !Retired

 Scr:Message = 'No Benefits'         !Consultant

END

 

See Also:

CHOOSE