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

 radjust()           Right-adjust a string
------------------------------------------------------------------------------
 Declaration
   string.hdr

 Syntax
   func char radjust extern
   param const char cString

 Arguments
   cString is a character string.

 Return
   The right-adjusted derivative of the input string.

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

 Example
   #define EXAMPLE_STRING
   #include example.hdr

   proc Test_radjust
   ? ">" + radjust( "         test" ) + "<"     // output: >         test<
   ? ">" + radjust( "    test     " ) + "<"     // output: >         test<
   ? ">" + radjust( "test         " ) + "<"     // output: >         test<
   ? ">" + radjust( "test"          ) + "<"     // output: >test<
   endproc

   proc main
   Test_radjust()
   endproc