Conteúdo
Índice 🔎︎

# Função Chr

Retorna o caractere que corresponde ao código de caractere especificado.

### Sintaxe:

          Chr[$](codigochar As Integer) As String

### Valor de retorno:

String

### Parâmetros:

codigochar: uma expressão numérica que representa um valor de 8 bit ASCII (0-255) ou um valor de 16 bits Unicode. (Para dar suporte a expressões com argumentos nominais negativos tal como Chr(&H8000) para fins de compatibilidade regressa, valores no intervalo −32768 a −1 são mapeados internamente no intervalo 32768 a 65535.)

Quando o modo de compatibilidade com o VBA estiver ativo (Option VBASupport 1), codigochar é uma expressão numérica que representa somente um valor válido ASCII de 8 bits (0-255).

Use a função Chr$ para enviar sequências de controles especiais para uma impressora ou para outra fonte de saída. Você também pode usá-la para inserir aspas na expressão da cadeia de caracteres.

### Códigos de erro:

5 Chamada de procedimento inválida

6 Excedida a capacidade

Um erro de estouro ocorrerá quando o modo de compatibilidade VBA estiver habilitado e o valor da expressão for maior que 255.

### Exemplo:

            Sub ExampleChr
                ' Esse exemplo insere aspas (ASCII valor 34) em uma cadeia de caracteres.
                MsgBox "Uma " + Chr$(34) + "viagem" + Chr(34) + " curta."
                ' A saída aparece na caixa de diálogo como: A "short" trip.
                MsgBox Chr(charcode := 64) ' Símbolo "@"
            End Sub

Tópicos relacionados

Função Asc (BASIC)

Função [VBA] AscW

Funcão ChrW [VBA]