Chr, ChrW (Funciones)

Artículo
10/07/2008

Actualización: noviembre 2007

Devuelve el carácter asociado al código de carácter especificado.

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

Parámetros

CharCode
Obligatorio. Expresión Integer que representa el punto de código (code point) o código de carácter del carácter. Si CharCode está fuera del intervalo válido, aparece un error ArgumentException. El intervalo válido para Chr es de 0 a 255 y para ChrW, de -32768 a 65535.

Excepciones

Tipo de excepción	Número de error	Condición
ArgumentException	5	CharCode < -32768 o > 65535 para ChrW.
ArgumentException	5	CharCode < 0 o > 255 para Chr.

Consulte la columna "Número de error" si está actualizando aplicaciones de Visual Basic 6.0 que utilizan el control de errores no estructurado. (Se puede comparar el número de error con respecto a Number (Propiedad, objeto Err)). Sin embargo, siempre que sea posible, se debe considerar la sustitución de dicho control de errores por Información general sobre el control estructurado de excepciones de Visual Basic.

Comentarios

El intervalo asimétrico aceptado para CharCode compensa las diferencias de almacenamiento entre Short (Tipo de datos, Visual Basic) e Integer (Tipo de datos, Visual Basic). Por ejemplo, -29183 es Short pero +36353 es Integer. De este modo también se facilita la compatibilidad con Visual Basic 6.0.

Chr utiliza la clase Encoding del espacio de nombres System.Text para determinar si el subproceso actual está utilizando un juego de caracteres de un solo byte (SBCS) o un juego de caracteres de doble byte (DBCS). Después utiliza como punto de código el CharCode del juego correspondiente. El intervalo puede ser del 0 al 255 para caracteres SBCS y del -32768 al 65535 para caracteres DBCS.

El valor devuelto depende de la página de códigos para el subproceso actual, que está en la propiedad ANSICodePage de la clase TextInfo en el espacio de nombres System.Globalization. Puede obtener ANSICodePage especificando System.Globalization.CultureInfo.CurrentCulture.TextInfo.ANSICodePage.

ChrW utiliza CharCode como punto de código Unicode. El intervalo no depende de la configuración de referencia cultural y página de códigos del subproceso actual. Los valores del -32768 al -1 se tratan igual que los valores del intervalo del +32768 al +65535.

Los números del 0 al 31 son los mismos que los códigos ASCII estándar no imprimibles. Por ejemplo, Chr(10) devuelve un carácter de avance de línea.

Nota:
La función ChrB en las versiones anteriores de Visual Basic devuelve un byte único. Se utiliza principalmente para convertir cadenas en aplicaciones de juegos de caracteres de doble byte (DBCS). En Visual Basic y en .NET Framework, todas las cadenas están en Unicode y ya no se admite ChrB.

Ejemplo

En el ejemplo siguiente se utiliza la función Chr para devolver el carácter asociado al código de carácter especificado.

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