Mostrar tudo

Ocultar tudo

Devolve uma Variante (Cadeia) que representa um número.

Sintaxe

Cad(número)

O argumento (argumento: valor que fornece informações a uma acção, evento, método, propriedade, função ou procedimento.) número obrigatório é um valor Longo (tipo de dados longo: tipo de dados fundamental que contém números inteiros grandes. Uma variável do tipo Longo é armazenada como um número de 32 bits que varia entre -2.147.483.648 e 2.147.483.647.) que contém qualquer expressão numérica (expressão numérica: qualquer expressão que possa gerar um número. A expressão pode ser qualquer combinação de variáveis, constantes, funções e operadores.) válida.

Observações

Quando os números são convertidos em cadeias, é sempre reservado um espaço em branco no início para o sinal do número. Se o número for positivo, a cadeia devolvida contém um espaço em branco no início e o sinal de adição está implícito.

Utilize a função Formatar para converter valores numéricos que pretenda formatar como datas, horas ou moeda ou noutros formatos definidos pelo utilizador. Ao contrário da função Cad, a função Formatar não inclui um espaço em branco no início para o sinal do número.

 Nota    A função Cad reconhece apenas o período (.) como um separador decimal válido. Quando for possível utilizar separadores decimais diferentes (por exemplo, em aplicações internacionais), utilize CCad para converter um número numa cadeia.

Exemplo

 Nota   Os exemplos que se seguem demonstram a utilização desta função num módulo do Visual Basic for Applications (VBA). Para mais informações sobre como trabalhar com VBA, seleccione Referência para Programadores na lista pendente junto a Procurar e introduza um ou mais termos na caixa de procura.

Este exemplo utiliza a função Cad para devolver uma representação em cadeia de um número. Quando um número é convertido numa cadeia, é sempre reservado um espaço em branco no início para o respectivo sinal.

Dim MyString
MyString = Str(459)    ' Returns " 459".
MyString = Str(-459.65)    ' Returns "-459.65".
MyString = Str(459.001)    ' Returns " 459.001".