CStr

Devolve uma expressão que foi convertida num Variant do subtipo String.

Estrutura

CStr(expressão)

Parâmetros

O argumento «expressão» pode ser qualquer expressão válida.

Descrição

Em geral, pode documentar o seu código utilizando as funções de conversão de tipos de dados para indicar que o resultado de uma determinada operação deve ser expresso num tipo de dados específico, em vez do tipo de dados predefinido. Por exemplo, utilize CStr para forçar a conversão do resultado para um String.

Deve utilizar a função CStr em vez de Str para realizar conversões compatíveis com normas internacionais de qualquer outro tipo de dados para um subtipo String. Por exemplo, os diferentes separadores decimais são reconhecidos corretamente, dependendo da configuração regional do seu sistema.

Os dados na expressão determinam o que é devolvido, de acordo com a tabela seguinte:

Se a expressão for CStr, retorna

Boolean: uma cadeia de caracteres contendo True ou False.

Data Uma cadeia de caracteres que contém uma data no formato de data curto do seu sistema.

Null Um erro de tempo de execução.

Vazio: Uma cadeia de caracteres de comprimento zero ('').

Erro Uma sequência de caracteres que contém a palavra «Erro», seguida do número do erro.

Outro valor numérico Uma cadeia de caracteres que contém o número.

Exemplo

O exemplo seguinte utiliza a função CStr para converter um valor numérico numa cadeia de caracteres:

Dim MyDouble, MyString

; MyDouble = 437,324 ' MyDouble é um Double.

MyString = CStr(MyDouble) ' MyString contém '437,324'. |