$FUNCNAME$
  LTRIM()
$CATEGORY$
  STRING
$SUMMARY$
   Remove leading spaces from a character string
$LANG_RU$
        .
$SYNTAX$
     LTRIM(<cString>) --> cTrimString
$LANG_RU$
     LTRIM(< >) -->  
$ARGUMENTS$
     <cString> is the character string to copy without leading spaces.
$LANG_RU$
     < > -  .
$RETURNS$
     LTRIM() returns a copy of <cString> with the leading spaces removed.  If
     <cString> is a null string ("") or all spaces, LTRIM() returns a null
     string ("").
$LANG_RU$
     LTRIM()    < >  
      .  < >  
      ("")  ,    , LTRIM()
        ("").
$DESCRIPTION$

     LTRIM() is a character function that formats character strings with
     leading spaces.  These can be, for example, numbers converted to
     character strings using STR().

     LTRIM() is related to RTRIM(), which removes trailing 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.


$LANG_RU$

     LTRIM()     , 
           .  
     , , ,     
     STR().

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


$EXAMPLES$

       These examples illustrate LTRIM() used with several other
	functions:

	nNumber = 18
	? STR(nNumber)                  // Result: 18
	? LEN(STR(nNumber))            // Result: 10

	? LTRIM(STR(nNumber))         // Result: 18
	? LEN(LTRIM(STR(nNumber)))      // Result:  2


$LANG_RU$

          LTRIM()   
         :

       nNumber = 18
       ? STR(nNumber)                  // : 18
       ? LEN(STR(nNumber))             // : 10
       ? LTRIM(STR(nNumber))           // : 18
       ? LEN(LTRIM(STR(nNumber)))      // : 2


$SEEALSO$
  ALLTRIM(),PAD(),RTRIM(),STR(),SUBSTR(),TRIM()
$END$
