IfContains()

OutputVar := Mfunc.IfContains(ByRef var, MatchList)

Mfunc.IfContains(ByRef var, MatchList)

Checks whether a variable's contents match one of the items in a list.

Parameters

Var

The name of the variable whose contents will be checked. For the "contains" operator, a match occurs more easily: whenever Var contains one of the list items as a substring.

MatchList

A comma-separated list of strings, each of which will be compared to the contents of Var for a match. Any spaces or tabs around the delimiting commas are significant, meaning that they are part of the match string. For example, if MatchList is set to "ABC , XYZ" then Var must contain either ABC with a trailing space or XYZ with a leading space to cause a match.

Returns

Returns true if var is contained in MatchList; otherwise false.

Remarks

The comparison is always done alphabetically, not numerically.
Static Method.

Example

if (Mfunc.IfIn(var, "exe,bat,com")) {
	MsgBox The file extension is an executable type.
}

if (Mfunc.IfIn(var, "1,2,3,5,7,11")) { ; Avoid spaces in list.
	MsgBox %var% is a small prime number.
}

if (Mfunc.IfContains(var, "1,3")) { ; Note that it compares the values as strings, not numbers.
	MsgBox Var contains the digit 1 or 3 (Var could be 1, 3, 10, 21, 23, etc.)
}

if (Mfunc.IfIn(var, MyItemList)) { ; Avoid spaces in list.
	MsgBox %var% is in the list.
}


InputBox, UserInput, Enter YES or NO
if (!Mfunc.IfIn(UserInput, "yes,no")) {
	MsgBox Your input is not valid.
}


WinGetTitle, active_title, A
if (Mfunc.IfContains(active_title, "Address List.txt,Customer List.txt")) { ; Note that it compares the values as strings, not numbers.
	MsgBox One of the desired windows is active.
}
if (!Mfunc.IfContains(active_title, "metapad,Notepad")) { ; Note that it compares the values as strings, not numbers.
	MsgBox But the file is not open in either Metapad or Notepad.
}