prefix bytecodeproc with xasm_
[xorcyst.git] / doc / Custom-Character-Maps.html
blob98775e6735ae3ce8670678ca6269480ace2ed29b
1 <html lang="en">
2 <head>
3 <title>Custom Character Maps - The XORcyst Manual</title>
4 <meta http-equiv="Content-Type" content="text/html">
5 <meta name="description" content="The XORcyst Manual">
6 <meta name="generator" content="makeinfo 4.7">
7 <link title="Top" rel="start" href="index.html#Top">
8 <link rel="prev" href="Object-Code-Format.html#Object-Code-Format" title="Object Code Format">
9 <link rel="next" href="Error-and-Warning-Messages.html#Error-and-Warning-Messages" title="Error and Warning Messages">
10 <link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
11 <!--
12 This is the manual for The XORcyst version 1.5.2.
14 Copyright (C) 2004, 2005, 2007, 2008, 2009 Kent Hansen.-->
15 <meta http-equiv="Content-Style-Type" content="text/css">
16 <style type="text/css"><!--
17 pre.display { font-family:inherit }
18 pre.format { font-family:inherit }
19 pre.smalldisplay { font-family:inherit; font-size:smaller }
20 pre.smallformat { font-family:inherit; font-size:smaller }
21 pre.smallexample { font-size:smaller }
22 pre.smalllisp { font-size:smaller }
23 span.sc { font-variant:small-caps }
24 span.roman { font-family: serif; font-weight: normal; }
25 --></style>
26 </head>
27 <body>
28 <div class="node">
29 <p>
30 <a name="Custom-Character-Maps"></a>Next:&nbsp;<a rel="next" accesskey="n" href="Error-and-Warning-Messages.html#Error-and-Warning-Messages">Error and Warning Messages</a>,
31 Previous:&nbsp;<a rel="previous" accesskey="p" href="Object-Code-Format.html#Object-Code-Format">Object Code Format</a>,
32 Up:&nbsp;<a rel="up" accesskey="u" href="index.html#Top">Top</a>
33 <hr><br>
34 </div>
36 <h2 class="appendix">Appendix E Custom Character Maps</h2>
38 <!-- Using custom character maps is a convenient way of mapping ASCII characters to a different encoding. -->
39 <p>A custom character map is a plaintext file containing statements of the form
40 <pre class="example"> <var>key</var> = <var>value</var>
41 </pre>
42 <p>where <var>key</var> is a character or escape sequence and <var>value</var> is the integer literal instances of this character should be mapped to when occuring as argument to the <code>.char</code> assembler directive.
44 <p>There is a also a shorthand form for mapping a range of characters at once:
45 <pre class="example"> <var>low_key</var>-<var>high_key</var> = <var>value</var>
46 </pre>
47 <p>This is most useful when mapping the decimal digits and the alphabet. Instead of typing monotonic statements like
48 <pre class="example"> 0=0x10
49 1=0x11
50 ...
51 9=0x19
52 </pre>
53 <p>you can achieve the same result from the statement
54 <pre class="example"> 0-9=0x10
55 </pre>
56 </body></html>