UCase

Returns an upper case copy of a string

Syntax
	KeyPgDeclareDeclare KeyPgFunctionFunction UCase ( KeyPgByrefByRef str KeyPgAsAs KeyPgConstQualifierConst KeyPgStringString, KeyPgByvalByVal mode KeyPgAsAs KeyPgLongLong = 
	0 ) KeyPgAsAs KeyPgStringString
	KeyPgDeclareDeclare KeyPgFunctionFunction UCase ( KeyPgByrefByRef str KeyPgAsAs KeyPgConstQualifierConst KeyPgWstringWString, KeyPgByvalByVal mode KeyPgAsAs KeyPgLongLong 
	= 0 ) KeyPgAsAs KeyPgWstringWString

Usage
	result = UCase[$]( str [ , mode ] )

Parameters
	str
		String to convert to uppercase.
	mode
		The conversion mode: 0 = current locale, 1 = ASCII only

Return Value
	Uppercase copy of str.

Description
	Returns a copy of str with all of the letters converted to upper case.

	If str is empty, the null string ("") is returned.

Example
	Print UCase("AbCdEfG")

	will produce the output:

	ABCDEFG

Platform Differences
	* The wide-character string version of UCase is not supported for DOS 
	  target.

Dialect Differences
	* The string type suffix "$" is required in the CompilerOptlang-lang qb dialect.
	* The string type suffix "$" is optional in the CompilerOptlang-lang fblite dialect.
	* The string type suffix "$" is ignored in the CompilerOptlang-lang fb dialect, warn 
	  only with the CompilerOptw-w suffix compile option (or CompilerOptw-w pedantic compile 
	  option).

Differences from QB
	* QB does not support Unicode.

See also
	* KeyPgLcaseLCase

