filename.iomap-file Definition/Access: General


Command filename.iomap-file Definition/Access: General
Applicable release versions: AP
Category Access: General (65)
Description defines the one-to-one keyboard input and output translation used by the "set-iomap" command. The data section of the file contains items that define the character translation. The dictionary level contains binary items which are compiled by the "set-iomap" program when used with the "c" option. The items in the dictionary have the same item-id's as the corresponding items in the data section, except that the (dictionary) items are preceded and followed by a "%".

Each item in the data section contains up to 33 attributes. Attribute 1 is used for comments. Attributes 2 through 33 contain data for the actual character translation. Each attribute consists of 8 characters (32 x 8 = 256, the number of characters in the ASCII set). ASCII characters 0 through 7 (in hex) are stored in attribute 2. Characters 8 through 16 are stored in attribute 3, and so on. The "set-iomap" program reads a specified item from the "iomap-file" and converts the ASCII characters into binary equivalents, then writes the item to the dictionary level of the "iomap-file".
set-iomap 1234 (c
Assuming that there was an item in the "iomap-file" that contained 
the following:

item-id:   1234

Attr#      Contents

1        this is just a comment
2        0001020304050607
3        08090a0b0c0d0e0f
9        6061626364656667
10       68696a6b6c6d6e6f
11       7071727374757677
12       78797a7b7c7d7e7f
33       f8f9fafbfcfdfeff

This translates the characters "A" through "Z" into 
"a" through "z". All  other characters remain the same. The 
resulting item, "%1234%" would then be written to the dictionary of 
the "iomap-file".
Related tcl.set-iomap