Home > CBM > BASIC > Keywords > Chr
180 Subpages: (divide), (equal), (less), (minus), (more), (multiply), (plus), (power), Abs, And, Append, Asc, Atn, Auto, Backup, Bank, Begin, Bend, Bload, Boot, Box, Bsave, Bump, Catalog, Char, Circle, Close, Clr, Cmd, Collect, Collision, Color, Concat, Cont, Copy, Cos, Data, Dclear, Dclose, Dec, Def, Delete, Dim, Directory, Dispose, Dload, Do, Dopen, Draw, Ds, Ds string, Dsave, Dverify, El, Else, End, Envelope, Er, Err, Exit, Exp, Fast, Fetch, Filter, Fn, For, Fre, Get, Get num, Getkey, Go, Gosub, Goto, Graphic, Gshape, Header, Help, Hex, If, Input, Input num, Instr, Int, Joy, Key, Left, Len, Let, List, Load, Locate, Log, Loop, Mid, Monitor, Movspr, New, Next, Not, Off, On, Open, Or, Paint, Peek, Pen, Pi, Play, Pointer, Poke, Pos, Pot, Print, Print num, Pudef, Quit, Rclr, Rdot, Read, Record, Rem, Rename, Renumber, Restore, Resume, Return, Rgr, Right, Rlum, Rnd, Rreg, Rspcolor, Rsppos, Rsprite, Run, Rwindow, Save, Scale, Scnclr, Scratch, Sgn, Sin, Sleep, Slow, Sound, Spc, Sprcolor, Sprdef, Sprite, Sprsav, Sqr, Sshape, St, Stash, Step, Stop, Str, Swap, Sys, Tab, Tan, Tempo, Then, Ti, Ti string, To, Trap, Troff, Tron, Until, Using, Usr, Val, Verify, Vol, Wait, While, Width, Window, Xor

KeywordAbbreviationToken (hex)Version(s)Classification
CHR$C{Shift+H}C71.0+Function
The keyword includes the '$' character.

  Syntax  
CHR$ ( code )

ParametersTypeLegal Value(s)Default ValueNote(s)
codeInteger
0 to 255

ReturnsTypeValue(s)Note(s)
characterString
1 character
the actual character depends on code

  Purpose  
Return the character which corresponds to a numeric code.

  Remarks  
The CHR$ function simply returns a string containg the character with the given code.   For a list of codes for the uppercase/graphics character set, see the ASCII-X page.  For a list of codes for the lowercase/uppercase character set, see the PETSCII page.  Actually the computer doesn't care which character set is used; but to the human viewing the characters, it can make a huge difference!  Also note those tables have some duplicates; generally you can use either code to generate such characters, but the ones marked "Primary" are recommended as some devices or other software may not understand the "Alternate" code.

The CHR$ function is especially usefull for generating characters that can't be entered as a literal value in a BASIC program: double-quote ("), RETURN, or NULL.

You will get TYPE MISMATCH ERROR with a string expression or variable given for the code (the VAL function may help).  A floating-point code will be converted to an integer (see INT).  An ILLEGAL QUANTITY ERROR is generated if the code is not a Legal Value (see table above).


Examples (uppercase/graphics character set):
PRINT CHR$("65")
?TYPE MISMATCH ERROR 

READY.
PRINT CHR$(65)
A

READY.
PRINT CHR$(193)
♠

READY.

Examples (lowercase/uppercase character set):
print chr$("65")
?type mismatch error 

ready.
print chr$(65)
a

ready.
print chr$(193)
A

ready.

  Compare With  
ERR$, HEX$, STR$

  Contrast With  
ASC, DEC, INSTR, LEN, VAL

  See Also  
PRINT, PRINT#


© H2Obsession, 2014