NAME

chr$ - convert ASCII code to character

SYNOPSIS

v$ = chr$(NumExpr)

DESCRIPTION

Chr$ returns a one-character string consisting of the character specified by the ASCII code provided as its argument.  The argument may be any numeric expression. 

The chr$ function and the asc function are inverses in the sense that asc(chr$(NumExpr)) equals NumExpr for any numeric expression NumExpr whose value is between 0 and 255 inclusive.  However, note that chr$(asc(StrExpr)) equals StrExpr only for string expressions StrExpr of a single character. 

EXAMPLE

As one example, a series of print chr$(7); statements, representing the BEL character, could be used to beep the speaker as part of an error routine. 

As another example, the following program displays the printable characters along with their ASCII codes:

	cls
	for i = 32 to 126 step 5
		for j = i to i+4
			print using "  ###  ! "; j, chr$(j);
		next j
		print
	next i

This program produces the output

	   32       33  !    34  "    35  #    36  $ 
	   37  %    38  &    39  '    40  (    41  ) 
	   42  *    43  +    44  ,    45  -    46  . 
	   47  /    48  0    49  1    50  2    51  3 
	   52  4    53  5    54  6    55  7    56  8 
	   57  9    58  :    59  ;    60  <    61  = 
	   62  >    63  ?    64  @    65  A    66  B 
	   67  C    68  D    69  E    70  F    71  G 
	   72  H    73  I    74  J    75  K    76  L 
	   77  M    78  N    79  O    80  P    81  Q 
	   82  R    83  S    84  T    85  U    86  V 
	   87  W    88  X    89  Y    90  Z    91  [ 
	   92  \    93  ]    94  ^    95  _    96  ` 
	   97  a    98  b    99  c   100  d   101  e 
	  102  f   103  g   104  h   105  i   106  j 
	  107  k   108  l   109  m   110  n   111  o 
	  112  p   113  q   114  r   115  s   116  t 
	  117  u   118  v   119  w   120  x   121  y 
	  122  z   123  {   124  |   125  }   126  ~ 

SEE ALSO

asc

DIAGNOSTICS

If NumExpr is less than 0 or greater than 255, an "Illegal function call" error occurs. 

from The Basmark QuickBASIC Programmer’s Manual by Lawrence Leinweber