char-external-code

char-external-code Function

Summary

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

Package

external-format

Signature

char-external-code char set => code

Arguments

`char`⇩	The character whose code you wish to return.
`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

code⇩

The code of char in the character set set. An integer.

Description

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.