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

 ladjust()           Left-adjust a string
------------------------------------------------------------------------------
 Declaration
   string.hdr

 Syntax
   func char ladjust extern
   param const char cString

 Arguments
   cString is a character string.

 Return
   The left-adjusted derivative of the input string.

 Description
   The ladjust() function left-adjusts the input string. If the parameter
   passed to ladjust() contains text preceeded by spaces, the function
   returns a string of equal length, with the spaces moved after the text.

 Example
   #define EXAMPLE_STRING
   #include example.hdr

   proc Test_ladjust
   ? ">" + ladjust( "         test" ) + "<"     // output: >test         <
   ? ">" + ladjust( "    test     " ) + "<"     // output: >test         <
   ? ">" + ladjust( "test         " ) + "<"     // output: >test         <
   ? ">" + ladjust( "test"          ) + "<"     // output: >test<
   endproc

   proc main
   Test_ladjust()
   endproc