Siebel VB Language Reference > Siebel VB Language Reference >

LCase Function


This standard VB function returns a lowercase copy of a string.

Syntax

LCase[$](string)

Argument
Description
string
A string or an expression containing a string

Returns

A copy of string, with uppercase letters converted to lowercase.

Usage

The substitution of characters is based on the country specified in the Windows Control Panel. LCase accepts expressions of type string. LCase accepts any type of argument and converts the input value to a string.

The dollar sign ($) in the function name is optional. If it is included, the return type is string. Otherwise the function returns a variant of vartype 8 (string). If the value of string is NULL, a variant of vartype 1 (Null) is returned.

The LCase or UCase function is useful for comparing string data when you need to compare the actual text values, but the case in which input is entered is irrelevant.

Example

This example converts a string entered by the user to lowercase.

Sub Button_Click
      Dim userstr as String
   userstr = "This Is A Test"
   userstr = LCase$(userstr)
End Sub

See Also

UCase Function


 Siebel VB Language Reference
 Published: 18 June 2003