xHarbour Reference Documentation > Function Reference

Upper()

Converts a character string to uppercase.

Syntax

Upper( <cString> ) --> cUpperCaseString

Arguments

<cString>

A character string to convert to uppercase letters.

Return

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

Description

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

Info

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

Example

// The example demonstrates various results of Upper()

   PROCEDURE Main

      ? Upper( "xHARbOUR" )            // result: XHARBOUR
      ? Upper( "123 ABC - def" )       // result: 123 ABC - DEF

   RETURN