LCase

FreeBASIC

LCase
 
Returns a lower case copy of a string

Syntax

Declare Function LCase ( ByRef str As Const String, ByVal mode As Long = 0 ) As String
Declare Function LCase ( ByRef str As Const WString, ByVal mode As Long = 0 ) As 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 obligatory in the -lang qb dialect.
  • The string type suffix "$" is optional in the -lang fblite and -lang fb dialects.

Differences from QB

  • QB does not support Unicode.

See also