Function

Summary

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

Package

external-format

Signature

find-external-char code set => char

Arguments

code

A character code. This is an integer.

set

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.

Values

char

The character represented by code. If code is not a legal code in the specified set, the return value is undefined.

Description

Returns the character that has the code code (an integer) in the coded character set specified by set, or nil, if that character is not represented in the Lisp character set. Note that a coded character set is not the same thing as an external format.

For the set parameter, the :jis-* codes are KUTEN indexes (from the 1990 version of these standards) encoded as

(+ (* 100 row) column)

:euc-jp is the complete two-byte format encoded as

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

:sjis 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

char-external-code