Fonctions Chr, ChrW

Article
09/12/2008

Mise à jour : novembre 2007

Retourne le caractère associé au code de caractère spécifié.

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

Paramètres

CharCode
Requis. Expression Integer représentant le point de code (ou code de caractère) du caractère. Si CharCode se trouve en dehors de la plage valide, une erreur ArgumentException se produit. La plage valide pour Chr s'étend de 0 à 255, et la plage valide pour ChrW s'étend de -32 768 à 65 535.

Exceptions

Type d'exception	Numéro de l'erreur	Condition
ArgumentException	5	CharCode est inférieur à -32 768 ou supérieur à 65 535 pour ChrW.
ArgumentException	5	CharCode est inférieur à 0 ou supérieur à 255 pour Chr.

Consultez la colonne « Numéro d'erreur » si vous mettez à niveau des applications Visual Basic 6.0 qui utilisent la gestion des erreurs non structurée. (Vous pouvez comparer le numéro d'erreur par rapport à Number, propriété (objet Err).) Toutefois, lorsque cela est possible, vous devez envisager de remplacer un tel contrôle d'erreur par Vue d'ensemble de la gestion structurée des exceptions pour Visual Basic.

Notes

La plage asymétrique autorisée pour CharCode compense les différences de stockage entre les types de données Short, type de données (Visual Basic) et Integer, type de données (Visual Basic). Par exemple, -29 183 est un Short, mais +36 353 est un Integer. Ceci simplifie également la compatibilité avec Visual Basic 6.0.

Chr utilise la classe Encoding dans l'espace de noms System.Text pour déterminer si le thread en cours utilise un jeu de caractères codé sur un octet (SBCS, Single-Byte Character Set) ou sur deux octets (DBCS, Double-Byte Character Set). Il accepte ensuite CharCode comme un point de code dans le jeu approprié. La plage peut s'étendre de 0 à 255 pour les caractères SBCS et de -32 768 à 65 535 pour les caractères DBCS.

La valeur retournée dépend de la page de codes du thread en cours, contenue dans la propriété ANSICodePage de la classe TextInfo de l'espace de noms System.Globalization. Vous pouvez obtenir ANSICodePage en spécifiant System.Globalization.CultureInfo.CurrentCulture.TextInfo.ANSICodePage.

ChrW accepte CharCode comme un point de code Unicode. La plage est indépendante des paramètres de la culture et de la page de code pour le thread en cours. Les valeurs comprises entre -32 768 et -1 sont traitées de la même façon que les valeurs comprises entre +32 768 et +65 535.

Les nombres de 0 à 31 sont identiques aux codes ASCII standard non imprimables. Par exemple, Chr(10) retourne un caractère de saut de ligne.

Remarque :
La fonction ChrB dans les versions antérieures de Visual Basic retourne un octet simple. Son rôle est d'abord de convertir des chaînes en applications à jeu de caractères codés sur deux octets (DBCS, Double-Byte Character Set). Toutes les chaînes Visual Basic et .NET Framework sont en Unicode, et la fonction ChrB n'est plus prise en charge.

Exemple

L'exemple suivant utilise la fonction Chr pour retourner le caractère associé au code spécifié.

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