specifies the default raw character encoding to use for input and output functions.


  • The default setting for $CharacterEncoding is $SystemCharacterEncoding.
  • The setting $CharacterEncoding=None takes all special characters to be represented externally by printable ASCII sequences such as [Name] and :nnnn.
  • $CharacterEncodings gives a list of all installed character encodings.
  • Typical examples include:
  • "AdobeStandard"Adobe standard PostScript font encoding
    "ASCII"full ASCII, with control characters
    "EUC"extended Unix code for Japanese
    "ISOLatin1"ISO 88591 standard
    "ISOLatin2"ISO 88592 standard
    "ISOLatin3"ISO 88593 standard
    "ISOLatin4"ISO 88594 standard
    "ISOLatinCyrillic"ISO 88595 standard
    "MacintoshRoman"Macintosh roman font encoding
    "PrintableASCII"printable ASCII
    "ShiftJIS"shiftJIS encoding of JIS X 02081990 and extensions
    "Symbol"symbol font encoding
    "Unicode"raw 16bit Unicode (with +1 byte ordering)
    "UTF8"Unicode transformation format
    "WindowsANSI"Windows standard font encoding
    "ZapfDingbats"Zapf dingbats font encoding
  • With $CharacterEncoding="encoding" characters that are included in the encoding can be input in their raw 8 or 16bit form, and will be output in this form.
  • Unencoded characters can be input and will be output in standard [Name] or :nnnn form.
  • When using a textbased interface, resetting the value of $CharacterEncoding has an immediate effect on standard input and output in a Wolfram System session.
  • When using the notebook front end, raw character encodings are normally handled automatically based on the fonts you use. Only raw 16bit Unicode is ever sent through the WSTP connection to the kernel.
  • $CharacterEncoding affects the input and output of all characters, including those in symbol names and comments.
  • $CharacterEncoding also affects characters that appear in Text primitives within graphics.


open all close all

Basic Examples  (1)

The default raw character encoding:

Click for copyable input

Properties & Relations  (1)

Introduced in 1996
Updated in 2007