$FUNCNAME$
  RTRIM()
$CATEGORY$
  STRING
$SUMMARY$
   Remove trailing spaces from a character string
$LANG_RU$
        .
$SYNTAX$
     [R]TRIM(<cString>) --> cTrimString
$LANG_RU$
     [R]TRIM(< >) -->   
$ARGUMENTS$
     <cString> is the character string to be copied without trailing
     spaces.
$LANG_RU$
     < > -  ,   
     .
$RETURNS$
     RTRIM() returns a copy of <cString> with the trailing spaces removed.
     If <cString> is a null string ("") or all spaces, RTRIM() returns a null
     string ("").
$LANG_RU$
     RTRIM()  ,    <
     >    .   
     < > -    ("")    
     ,  RTRIM()     ("").
$DESCRIPTION$
     RTRIM() is a character function that formats character strings.  It is
     useful when you want to delete trailing spaces while concatenating
     strings.  This is typically the case with database fields which are
     stored in fixed-width format.  For example, you can use RTRIM() to
     concatenate first and last name fields to form a name string.

     RTRIM() is related to LTRIM() which removes leading spaces, and
     ALLTRIM() which removes both leading and trailing spaces.  The inverse
     of ALLTRIM(), LTRIM(), and RTRIM() are the PADC(), PADR(), and PADL()
     functions which center, right-justify, or left-justify character strings
     by padding them with fill characters.  RTRIM() is exactly the same as
     TRIM() in function.
$LANG_RU$
     RTRIM() -    ,  
        ,    . 
     ,        .
           ,    
      .

     ,   RTRIM()     
      ,      .

     RTRIM()   LTRIM(),     
      ,  ALLTRIM(),      , 
       .       PADC(),
     PADR()  PADL(),       
     ,   -.
$EXAMPLES$

       This is a user-defined function in which RTRIM() formats city,
	state, and zip code fields for labels or form letters:

	FUNCTION CityState(cCity, cState, cZip)
	   RETURN RTRIM(cCity) + ", " ;
	    + RTRIM(cState) + "  " + cZip

       In this example the user-defined function, CityState(),
	displays a record from Customer.dbf:

	USE Customer INDEX CustName NEW
	SEEK "Kate"
	? CityState(City, State, ZipCode)
	// Result: Athens, GA 10066


$LANG_RU$

          ,  
       RTRIM()    CITY, STATE  ZIP.

       FUNCTION CityState( cCity, cState, cZip)
	  RETURN RTRIM(cCity) + ", " + RTRIM(cState) + " " + cZip

         CityState()     Customer.dbf

       USE Customer INDEX CustName NEW
       SEEK "Kate"
       ? CityState(City,State,ZipCode)    // : Athens, GA 10066


$SEEALSO$
  PAD(),SUBSTR(),TRIM(),ALLTRIM(),LTRIM()
$END$
