$FUNCNAME$
  UPPER()
$CATEGORY$
  STRING
$SUMMARY$
   Convert lowercase characters to uppercase
$LANG_RU$
          
$SYNTAX$
     UPPER(<cString>) --> cUpperString
$LANG_RU$
     UPPER(< >) -->     
$ARGUMENTS$
     <cString> is the character string to be converted.
$LANG_RU$
     < > -    .
$RETURNS$
     UPPER() returns a copy of <cString> with all alphabetical characters
     converted to uppercase.  All other characters remain the same as in the
     original string.
$DESCRIPTION$
     UPPER() is a character function that converts lowercase and mixed case
     strings to uppercase.  It is related to LOWER() which converts uppercase
     and mixed case strings to lowercase.  UPPER() is related to the
     ISUPPER() and ISLOWER() functions which determine whether a string
     begins with an uppercase or lowercase letter.

     UPPER() is generally used to format character strings for display
     purposes.  It can, however, be used to normalize strings for case-
     independent comparison or INDEXing purposes.
$LANG_RU$
     UPPER() -    .  
              
        .     LOWER(),
            
          .  UPPER() 
        ISUPPER()  ISLOWER(),  ,
             .

     UPPER()      .
      UPPER()       ,
        .
$EXAMPLES$

       These examples illustrate the effects of UPPER():

	? UPPER("a string")           // Result: A STRING
	? UPPER("123 char = <>")      // Result: 123 CHAR = <>

       This example uses UPPER() as part of a case-independent
	condition:

	USE Customer INDEX CustName NEW
	LIST CustName FOR "KATE" $ UPPER(Customer)

       UPPER() is also useful for creating case-independent index key
	expressions:

	USE Customer NEW
	INDEX ON UPPER(Last) TO CustLast

       Later, use the same expression to look up Customers:

	MEMVAR->Last = SPACE(15)
	@ 10, 10 GET MEMVAR->Last
	READ

	SEEK UPPER(MEMVAR->Last)


$LANG_RU$

            UPPER():

       ? UPPER("")                     // : 
       ? UPPER("123  =<>")              // : 123  =<>

         UPPER()   ,  
       :

       USE Customer INDEX CustName NEW
       LIST CustNum FOR "KATE" $ UPPER(Customer)

      UPPER()       ,
          :

       USE Customer NEW
       INDEX ON UPPER(last) TO CustLst

      ,      Customer:

       MEMVAR->Last = SPACE(15)
       @ 10, 10 GET MEMVAR->Last
       READ
       SEEK UPPER(MEMVAR->Last)


$SEEALSO$
  ISLOWER(),ISUPPER(),LOWER()
$END$
