xHarbour Reference Documentation > Function Reference

Lower()

Converts a character string to lowercase.

Syntax

Lower( <cString> ) --> cLowerCaseString

Arguments

<cString>

A character string to convert to lowercase letters.

Return

The return value is a character string containing only lowercase letters.

Description

The character function Lower() copies the passed string, replaces all uppercase letters with lowercase letters and returns the result. It is related to function Upper() wich converts a string to uppercase letters. Both functions are used for case-insensitive string routines.

Info

See also:	IsLower(), IsUpper(), Upper()
Category:	Character functions
Source:	rtl\strcase.c
LIB:	xhb.lib
DLL:	xhbdll.dll

Example

// The example demonstrates various results of LOWER()

   PROCEDURE Main

      ? Lower( "xHARbOUR" )            // result: xharbour
      ? Lower( "123 ABC - def" )       // result: 123 abc - def

   RETURN