| **Navigation:**  [[introduction.htm|Language Reference]] > 13 - Built-in Functions >====== INLIST (return entry in list) ====== | [[incomplete  return empty req control .htm|{{btn_prev_n.gif|Previous page}}]][[introduction.htm|{{btn_home_n.gif|Return to chapter overview}}]][[inrange  check number within range .htm|{{btn_next_n.gif|Next page}}]] |
|  ||

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

{{blk2blue.jpg|blk2blue.jpg}}

| **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  return chosen value .htm|CHOOSE]]