Function
	makeupper

Purpose
	Converts a string into all upper case.

Return Type
	str

Syntax
	makeupper ( 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 upper 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 upper 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 makeupper(str("abc"))

	Will show the upper case version of the string "abc".


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

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

Invalid Examples
	echo makeupper(str(9870))

	Will produce error. The makeupper 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
makelower
makestr
makereal
makeint
makebool
conversion
systemvar