Click above to get retro games delivered to your door ever month!

 upper()             Convert lowercase characters to uppercase
------------------------------------------------------------------------------
 Declaration
   string.hdr

 Syntax
   func char upper extern
   param const char cString

 Arguments
   cString is a character string.

 Return
   A string derived from the input string with all characters converted to
   upper case.

 Description
   The upper() function returns a representation of cString where all
   of the lowercase characters have been converted to uppercase.

   The function respects the extended characters as well, according to the
   following scheme:

   from:  . . . . . . . . . . . . . . . . . . . . . . . . . .

   to:    . . . . . . . . . A A E E E I I I I O O O U U U Y A

 Example
   #define EXAMPLE_STRING
   #include example.hdr

   proc Test_upper
   ? upper( "jbl m.d.")             // prints "JBL M.D."
   ? upper( "heureka" )             // prints "HEUREKA"
   ? upper( left( "abcdEFG", 4 ) )  // prints "ABCD"
   endproc

   proc main
   Test_upper()
   endproc