Função Str

Devolve uma representação de Variante (Cadeia) de um número.

Sintaxe

Str(number)

O argumentode número necessário é um Long que contém qualquer expressão numérica válida.

Comentários

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

Utilize a função Formatar para converter valores numéricos que pretende formatar como datas, horas ou moeda ou noutros formatos definidos pelo utilizador. Ao contrário de Str, a função Format não inclui um espaço à esquerda para o sinal de número.

Observação

A função Str reconhece apenas o ponto final ( . ) como um separador decimal válido. Quando podem ser utilizados diferentes separadores decimais (por exemplo, em aplicações internacionais), utilize CStr para converter um número numa cadeia.

Exemplo

Este exemplo utiliza a função Str para devolver uma representação de cadeia de carateres de um número. Quando um número é convertido numa cadeia, um espaço à esquerda é sempre reservado para o respetivo sinal.

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

Confira também

• Funções (Visual Basic for Applications)

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.