LCase

Returns a lower case copy of a string

Syntax
	KeyPgDeclareDeclare KeyPgFunctionFunction LCase ( 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 LCase ( KeyPgByrefByRef str KeyPgAsAs KeyPgConstQualifierConst KeyPgWstringWString, KeyPgByvalByVal mode KeyPgAsAs KeyPgLongLong 
	= 0 ) KeyPgAsAs KeyPgWstringWString

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

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

Return Value
	Lowercase copy of str.

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

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

Example
	Print LCase("AbCdEfG")

Output:

	abcdefg

Platform Differences
	* The wide-character string version of LCase 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
	* KeyPgUcaseUCase

