STR()
 Converte uma expressao numérica para uma cadeia de caracteres
------------------------------------------------------------------------------

 Sintaxe

     STR(<nNúmero>, [<nTamanho>], [<nDecimais>]) --> cNúmero

 Argumentos

     <nNúmero> é a expressao numérica a ser convertida para uma cadeia
     de caracteres.

     <nTamanho> é o tamanho da cadeia de caracteres a ser retornada
     incluindo dígitos decimais, ponto decimal, e sinal.

     <nDecimais> é a quantidade de casas decimais a serem retornadas.

 Retorno

     STR() retorna <nNúmero> formatado como uma cadeia de caracteres.  Se os
     argumentos opcionais de tamanho e decimais nao foram especificados,
     STR() retorna a cadeia de caracteres conforme as seguintes
     regras:

     Tabela 5-32: Resultados de STR() sem Argumentos
     ------------------------------------------------------------------------
     Expressao                     Tamanho do Valor de Retorno
     ------------------------------------------------------------------------
     Variável Campo                Tamanho do campo mais decimais
     Expressoes/constantes         Mínimo de 10 dígitos mais decimais
     VAL()                         Mínimo de 3 dígitos
     MONTH()/DAY()                 3 dígitos
     YEAR()                        5 dígitos
     RECNO()                       7 dígitos
     ------------------------------------------------------------------------

 Descriçao

     STR() é uma funçao que converte valores numéricos para cadeias de
     caracteres.  Ela é comumente utilizada para concatenar valores
     numéricos a cadeias de caracteres.  STR() é aplicada na exibiçao de
     números, criaçao de códigos tais como números de produtos, e criaçao de
     chaves de indexaçao que combinam dados do tipo numérico e caractere.

     STR() é semelhante a TRANSFORM(), que formata valores numéricos como
     cadeias de caracteres utilizando uma máscara ao invés de especificaçoes
     de tamanho e decimais.  Como TRANSFORM() usa uma máscara, ela pode
     inserir caracteres de formataçao tais como vírgulas, cifroes, e
     parênteses.

     O inverso de STR() é VAL(), a qual converte números presentes em
     cadeias de caracteres em valores numéricos.

 Notas

       Se <nTamanho> for menor do que a quantidade de dígitos
        numéricos inteiros em <nNúmero>, STR() retorna asteriscos ao invés
        do número.

       Caso <nTamanho> seja menor do que a quantidade de dígitos
        decimais necessários à parte decimal da cadeia de caracteres
        retornada, o Clipper arredonda o número para a quantidade de casas
        decimais disponíveis.

       Se <nTamanho> for especificado, mas <nDecimais> for omitido
        (sem casas decimais), o valor de retorno é arredondado para um
        inteiro.

 Exemplos

       Estes exemplos demonstram a faixa de valores retornados por
        STR(), de acordo com os argumentos especificados:

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

       Este exemplo utiliza STR() para criar um índice com uma chave
        composta de números de ordem e nomes de clientes:

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

 Arquivos:  Biblioteca CLIPPER.LIB.
 To download this example - click here.

See Also: TRANSFORM() VAL()