Funções Chr, ChrW

Artigo
08/25/2010

Retorna o caractere associado a código de caractere especificado.

Public Function Chr(ByVal CharCode As Integer) As Char
Public Function ChrW(ByVal CharCode As Integer) As Char

Parâmetros

CharCode
Obrigatório.Uma expressão Integer que representa o ponto de código , ou código de caractere, para o caractere.Se CharCode está fora do intervalo válido, ocorrerá um erro ArgumentException.O intervalo válido para Chr é de 0 a 255, e o intervalo válido para ChrW é-32768 a 65535.

Exceções

Tipo de exceção	Número de erro	Condição
ArgumentException	5	CharCode < -32768 ou > 65535 para ChrW.
ArgumentException	5	CharCode < 0 ou > 255 para Chr.

Ver a coluna " número de erro " se você estiver atualizando aplicativos Visual Basic 6.0 que usam manipulação de erros não estruturada.(Você pode comparar o número do erro com a Propriedade do Número (Erro de objeto).) Entretanto, quando for possivel, você pode considerar substituir tal controle de erro por Visão Geral sobre a Manipulação Estruturada de Exceções para o Visual Basic.

Comentários

O intervalo assimétrico aceito por CharCode compensa as diferenças de armazenamento entre o Tipo de dados Short (Visual Basic) e Tipo de Dados Inteiro (Visual Basic).Por exemplo,-29183 é um Short mas +36353 é um Integer.Isso também facilita a compatibilidade com Visual Basic 6.0.

Chr usa a classe Encoding no espaço de nomes System.Text para determinar se o segmento atual está usando um conjunto de caracteres de byte único (SBCS) ou um conjunto de caracteresde byte duplo (DBCS).Em seguida, leva CharCode como um ponto de código no conjunto apropriado.O intervalo pode ser de 0 a 255 para caracteres SBCS e -32768 a 65535 para caracteres DBCS.

O valor retornado depende de página de código para o segmento atual, que está contido na propriedade ANSICodePage da classe TextInfo no Espaço de Nomes System.Globalization.Você pode obter ANSICodePage especificando System.Globalization.CultureInfo.CurrentCulture.TextInfo.ANSICodePage.

ChrW utiliza CharCode como um ponto de código Unicode.O intervalo é independente das configurações da cultura e página de código para o segmento atual.Valores de-32768 a -1 são tratados da mesma forma que valores no intervalo de +32768 a +65535.

Os números de 0 a 31 são os mesmos códigos ASCII não imprimíveis padrão.Por exemplo, Chr(10) retorna que um caractere de linha de alimentação.

Observação:
O ChrB função nas versões anteriores do Visual Basic retorna um único byte. Isso é usado primariamente para converter strings em aplicações com conjuntos de caracteres de byte duplo (DBCS).Todas as sequências de caracteres no Visual Basic e no Framework .NET estão em Unicode, e ChrB não é mais suportado.

Exemplo

O exemplo a seguir usa a função Chr para retornar o caractere associado a código de caractere especificado.

Dim associatedChar As Char
' Returns "A".
associatedChar = Chr(65)
' Returns "a".
associatedChar = Chr(97)
' Returns ">".
associatedChar = Chr(62)
' Returns "%".
associatedChar = Chr(37)