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

 alltrim()           Remove leading and trailing spaces from a string
------------------------------------------------------------------------------
 Declaration
   string.hdr

 Syntax
   func char alltrim extern
   param const char cString

 Arguments
   cString is the source string to trim.

 Return
   The input string with leading and trailing spaces removed.

 Description
   The alltrim() function removes leading and trailing spaces from a string,
   i. e. it is equivalent to ltrim( rtrim( cString ) ).

 Example
   #define EXAMPLE_STRING
   #include example.hdr

   /*
   This example creates a string with both leading and trailing spaces, and
   then trims them with alltrim()
   */
   
   proc Test_alltrim
   vardef
      char cString
      char cTrimmed
   enddef
   cString := space( 10 ) + "Force" + space( 10 )
   cTrimmed := alltrim( cString )
   ? "|" + cString  + "|" + ", length is " + istr( len( cString  ) ) // length 25
   ? "|" + cTrimmed + "|" + ", length is " + istr( len( cTrimmed ) ) // length  5
   endproc

   proc main
   Test_alltrim()
   endproc