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

 capfirst()          Capitalize words in a string
------------------------------------------------------------------------------
 Declaration
   string.hdr

 Syntax
   func char capfirst extern
   param const char cString

 Arguments
   cString is the character string to convert.

 Return
   A string derived from the input string with first characters capitalized.

 Description
   The capfirst() function returns a character string in which the first
   character of each word within cString is converted to uppercase while
   the remaining characters are converted to lowercase.

 Example
   #define EXAMPLE_STRING
   #include example.hdr

   proc Test_capfirst
   ? capfirst( "adam schelin" )      // Output: Adam Schelin
   ? capfirst( "AFFORDABLE STEREO" ) // Output: Affordable Stereo
   ? capfirst( "Hello There" )       // Output: Hello There
   endproc

   proc main
   Test_capfirst()
   endproc