$FUNCNAME$
  STR()
$CATEGORY$
  STRING
$SUMMARY$
   Convert a numeric expression to a character string
$LANG_RU$
        .
$SYNTAX$
     STR(<nNumber>, [<nLength>], [<nDecimals>]) --> cNumber
$LANG_RU$
     STR(<>, [< >], [< >]) -->    
$ARGUMENTS$
     <nNumber> is the numeric expression to be converted to a character
     string.
     <nLength> is the length of the character string to return, including
     decimal digits, decimal point, and sign.
     <nDecimals> is the number of decimal places to return.
$LANG_RU$
     <> -  ,     .
     < > -    , 
      ,    .
     < > -     .
$RETURNS$
     STR() returns <nNumber> formatted as a character string.  If the
     optional length and decimal arguments are not specified, STR() returns
     the character string according to the rules.
$LANG_RU$
     STR()    <>,   
     .       
       , STR()     
      .
$DESCRIPTION$
     STR() is a numeric conversion function that converts numeric values to
     character strings.  It is commonly used to concatenate numeric values to
     character strings.  STR() has applications displaying numbers, creating
     codes such as part numbers from numeric values, and creating index keys
     that combine numeric and character data.

     STR() is like TRANSFORM(), which formats numeric values as character
     strings using a mask instead of length and decimal specifications.

     The inverse of STR() is VAL(), which converts character numbers to
     numerics.
$LANG_RU$
     STR()   ,  
         .   
           . STR()
          ,  ,
            
     ,      .

     STR()   TRANSFORM(),   
         ,    
        .  TRANSFORM()  , 
         ,  , 
        .

       STR()   VAL(),   
        .
$EXAMPLES$

       These examples demonstrate the range of values returned by
	STR(), depending on the arguments specified:

	nNumber:= 123.45
	? STR(nNumber)                   // Result:  123.45
	? STR(nNumber, 4)                // Result:  123
	? STR(nNumber, 2)                // Result:  **
	? STR(nNumber * 10, 7, 2)        // Result:  1234.50
	? STR(nNumber * 10, 12, 4)       // Result:  1234.5000
	? STR(nNumber, 10, 1)            // Result:  1234.5

       This example uses STR() to create an index with a compound key
	of order numbers and customer names:

	USE Customer NEW
	INDEX ON STR(NumOrders, 9) + CustName TO CustOrd


$LANG_RU$

          ,   
       STR()      :

       nNumber = 123.45
       ? STR(nNumber)                  // : 123.45
       ? STR(nNumber, 4)               // : 123
       ? STR(nNumber, 2)               // : **
       ? STR(nNumber * 10, 7, 2)       // : 1234.50
       ? STR(nNumber * 10, 12, 4)      // : 1234.5000
       ? STR(nNumber, 10, 1)           // : 1234.5

          STR()    
             :

       USE Customer NEW
       INDEX ON STR(NumOrders, 9) + CustName TO CustOrd


$SEEALSO$
  TRANSFORM(),VAL()
$END$
