cValToChar

Converte qualquer valor (numero, data, logico, array) em string. Substitui o spaghetti de Str() + DToC() + IIF() em concatenacoes.

Assinatura: cValToChar(xValor) -> cString

Retorna: Character

cValToChar aceita qualquer tipo e retorna a representacao string. Util pra concatenar valores em log/mensagem sem se preocupar com o tipo.

Sintaxe

cStr := cValToChar(xValor)

Exemplo

cValToChar(123)             // "123"
cValToChar(1234.56)         // "1234.56"
cValToChar(Date())          // "05/12/2026"
cValToChar(.T.)             // ".T."
cValToChar({"a", "b"})       // "{a,b}"
cValToChar(NIL)             // "NIL"

// Substitui isso:
cMsg := "Processou " + AllTrim(Str(nQtd)) + " registros em " + DToC(dHoje)

// Por isso:
cMsg := "Processou " + cValToChar(nQtd) + " registros em " + cValToChar(dHoje)

Pegadinhas

Numero: mantem casas decimais como esta — pra controlar formato, use Str(nVal, 12, 2) mesmo
Data: usa formato padrao do ambiente (pode mudar). Pra forcar pt-BR, use DToC()

Parâmetros

Nome	Tipo	Obrigatório	Descrição
`xValor`	Any	sim	Valor de qualquer tipo

Exemplos

Concatenar em log

ConOut("Total: " + cValToChar(nTotal))