Descrição
(NUMÉRICA) STR [AS] - Converte Numérico para Caracter adicionando espaços à esquerda.
|
Sintaxe
| Str( <nValor>, <nTam>, <nDecimais> ) |
Parâmetros
| Par |
Nome |
Tipo |
Descrição |
Default |
Obg |
Ref |
01
|
nValor |
Numérico |
Valor a Converter |
|
X |
|
| 02 |
nTam |
Numérico |
Comprimento (tamanho) da cadeia de caracteres a ser fornecida, incluindo as casas decimais, o ponto decimal e o sinal de negativo, se houver |
|
|
|
| 03 |
nDecimais |
Numérico |
Número de casas decimais a ser fornecido na cadeia de caracteres resultante |
|
|
|
Retorno
| Retorno |
Tipo |
Descrição |
| cRet |
Caracter
|
Resultado da Conversão
|
Exemplo
#INCLUDE "TOTVS.CH"
User Function Str()
Local nValor := 10
MsgInfo( 'Valor: ' + cValtoChar(nValor) + CRLF + 'Retorno: ' + Str( nValor ), 'UniversoADVPL' )
Return( Nil )
Resultado
Informações adicionais
|
Se as expressões numéricas 2 e 3 não forem especificadas, a cadeia de caracteres será fornecida de acordo com as regras relacionadas abaixo:
|
<Expressão Numérica 1>
|
Comprimento da cadeia de Caracteres
|
|
Campo de arquivo de dados
|
Idêntico ao comprimento do campo.
|
|
Expressões ou constantes
|
No mínimo 10 posições e as casas decimais.
|
|
VAL()
|
No mínimo 3 posições.
|
|
MONTH() ou DAY()
|
3 posições.
|
|
YEAR()
|
5 posições.
|
|
RECNO()
|
7 posições.
|
|
Gostou? Compartilhe com seus amigos e deixe um comentário! 😎
