|
Syntax
|
Chr[$](charcode)
ChrB[$](charcode)
ChrW[$](charcode)
|
|
Description
|
Returns the character whose value is Code.
|
|
Comments
|
The Chr$, ChrB$, and ChrW$ functions return a String, whereas the Chr, ChrB, and ChrW functions return a String variant.
These functions behave differently depending on the string format used by BasicScript. These differences are summarized in the following table:
|
|
|
??
Function
|
String
Format
|
??
Value between
|
??
Returns a
|
|
|
Chr[$]
|
SBCS
|
0 and 255
|
1-byte character string.
|
|
|
|
MBCS
|
??-32768 and 32767
|
1-byte or 2-byte MBCS character string depending on charcode.
|
|
|
|
Wide
|
??-32768 and 32767
|
2-byte character string.
|
|
|
ChrB[$]
|
SBCS
|
0 and 255
|
1-byte character string.
|
|
|
|
MBCS
|
0 and 255
|
1-byte character string.
|
|
|
|
Wide
|
0 and 255
|
1-byte character string.
|
|
|
ChrW[$]
|
SBCS
|
0 and 255
|
1-byte character string (same as the Chr and Chr$ functions)
|
|
|
|
MBCS
|
-32768 and 32767
|
1-byte or 2-byte MBCS character string depending on charcode.
|
|
|
|
Wide
|
??-32768 and 32767
|
2-byte character string.
|
|
|
The Chr$ function can be used within constant declarations, as in the following example:
Const crlf = Chr$(13) + Chr$(10)
Some common uses of this function are:
|
|
|
Chr$(9)
|
Tab
|
|
|
Chr$(13) + Chr$(10)
|
End-of-line (carriage return, linefeed)
|
|
|
Chr$(26)
|
End-of-file
|
|
|
Chr$(0)
|
Null
|
|
Example
|
Sub Main()
????????'Concatenates carriage return (13) and line feed (10) to
????????'CRLF$, then displays a multiple-line message using CRLF$
????????'to separate lines.
????????crlf$ = Chr$(13) + Chr$(10)
????????MsgBox "First line." & crlf$ & "Second line."
??
????????'Fills an array with the ASCII characters for ABC and
????????'displays their corresponding characters.
????????Dim a%(2)
????????For i = 0 To 2
??????????a%(i) = (65 + i)
????????Next i
????????MsgBox "The first three elements of the array are: " _
??????????& Chr$(a%(0)) & Chr$(a%(1)) & Chr$(a%(2))
End Sub
|
|
See Also
|
Asc, AscB, AscW (functions); Str, Str$ (functions).
|
CIMPLICITY
