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

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

 Syntax
   func char lower extern
   param const char cString

 Arguments
   cString is a character string.

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

 Description
   The lower() function converts all uppercase characters within
   cString to lower case.

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

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

   to:    . . . . . . . . . . . . . . . . . . . . . . . . . .

 Example
   #define EXAMPLE_STRING
   #include example.hdr

   // Use lower() to convert a string to a "common" form for easy processing.
   // This eliminates the worry about whether an operator typed "John" or
   // "JOHN"
   
   dbfdef names
      char( 20 ) first
      char( 20 ) last
   enddef
   
   indexdef
      char(20) nameind lower( names->first )
   enddef
   
   proc Test_lower
   ? lower( "Dr. Georgia Wiesner 1234" ) // digits are unaffected
   endproc

   proc main
   Test_lower()
   endproc