Function
	makelower

Purpose
	Converts a string into all lower case.

Return Type
	str

Syntax
	makelower ( str ( <str> ) )

Arguments
	<str>	A value of type string. This can be a constant,
		variable, another function, expression, inline
		command or a combination of these, together
		resulting in a value of type string.

Return Value
	A constant of type string. The lower case version of <str> is returned. The input string, <str>,
	whether it is a variable, expression, or anything else, remains unchanged.

Stream Input	
	Streams apply to commands and not to functions.

Stream Output
	Streams apply to commands and not to functions.

Stream Error
	Streams apply to commands and not to functions, although any errors
	will be written here.

Description
	This function returns the lower case version of the input string, specified in the
	input argument str.

Restrictions
	All system functions are declared as global, and can not be redeclared (overloaded).

Valid Examples
	echo makelower(str("ABC"))

	Will show the lower case version of the string "ABC".


	var str s
	set $s = { cat "log.txt" }
	set $s = makelower(str($s))
	echo $s > "log.txt"

	The above will convert the entire contents of the file log.txt into lower case.

Invalid Examples
	echo makelower(str(9870))

	Will produce error. The makelower function is expecting a value of type string.
	The supplied value, 9870, is of type integer. A value of type integer can not be
	automatically converted to a value of type string.

See Also
constant
var
makeupper
makestr
makereal
makeint
makebool
conversion
systemvar