All Manuals > LispWorks® User Guide and Reference Manual > 36 The EXTERNAL-FORMAT Package

char-external-code Function


Returns the code of a character in the specified character set.




char-external-code char set => code

The character whose code you wish to return.
A character set. Legal values for set are :unicode, :latin-1, :ascii, :macos-roman, :jis-x-208, :jis-x-212, :euc-jp, :sjis, :koi8-r, :windows-cp936 and :gbk. Additionally, on Windows, set can be a valid Windows code page identifier.
The code of char in the character set set. An integer.

The function char-external-code returns the code of the character char in the coded character set specified by set, or nil, if there is no encoding. Note that a coded character set is not the same thing as an external format.

If set is :jis-x-208 or :jis-x-212 then code is the KUTEN index (from the 1990 version of these standards) encoded as:

(+ (* 100 row) column)

If set is :euc-jp then code is the complete two-byte format encoded as:

(+ (* 256 first-byte) second-byte)

If set is :sjis then code is Shift-JIS encoded in the same way. Strictly speaking, EUC and Shift-JIS are not coded character sets, but encodings of the JIS sets, but the encoding is easily expressed as an integer, so the same interface to it is used.

See also

26.6 External Formats to translate Lisp characters from/to external encodings

LispWorks® User Guide and Reference Manual - 01 Dec 2021 19:30:34