(NUMÉRICA) STR [AS]

(NUMÉRICA) STR [AS]
Author: Eurai
Inclusão: 01/01/2016
Alteração: 25/07/2021

Descrição

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
str_-_resultado_01  

 

 

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! 😎  

 

 

 

 

 

 

 

Esse conteúdo te ajudou? Ajude o canal com doação
Compartilhar
Comentários