the10thwiz/cc65
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Support for the .BANKBYTES, .LOBYTES and .HIBYTES pseudo functions contributed

Browse Source 
by Kevin Schuetz <scrapdog@runbox.com>.


git-svn-id: svn://svn.cc65.org/cc65/trunk@3965 b7a2c559-68d2-44c3-8de9-860c34a00d81
This commit is contained in:
uz
2009-05-18 16:11:34 +00:00
parent 37e08cac59
commit 8e8993de7e
7 changed files with 173 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

109
doc/ca65.sgml
View File

@@ -1767,6 +1767,34 @@ Here's a list of all control commands and a description, what they do:
.autoimport + ; Switch on auto import
</verb></tscreen>
<sect1><tt>.BANKBYTES</tt><label id=".BANKBYTES"><p>
Define byte sized data by extracting only the bank byte (that is, bits 16-23) from
each expression. This is equivalent to <tt><ref id=".BYTE" name=".BYTE"></tt> with
the operator '^' prepended to each expression in its list.
Example:
<tscreen><verb>
.define MyTable TableItem0, TableItem1, TableItem2, TableItem3
TableLookupLo: .lobytes MyTable
TableLookupHi: .hibytes MyTable
TableLookupBank: .bankbytes MyTable
</verb></tscreen>
which is equivalent to
<tscreen><verb>
TableLookupLo: .byte &lt;TableItem0, &lt;TableItem1, &lt;TableItem2, &lt;TableItem3
TableLookupHi: .byte &gt;TableItem0, &gt;TableItem1, &gt;TableItem2, &gt;TableItem3
TableLookupBank: .byte ^TableItem0, ^TableItem1, ^TableItem2, ^TableItem3
</verb></tscreen>
See also: <tt><ref id=".BYTE" name=".BYTE"></tt>,
<tt><ref id=".HIBYTES" name=".HIBYTES"></tt>,
<tt><ref id=".LOBYTES" name=".LOBYTES"></tt>
<sect1><tt>.BSS</tt><label id=".BSS"><p>
@@ -2424,6 +2452,46 @@ Here's a list of all control commands and a description, what they do:
.globalzp foo, bar
</verb></tscreen>
<sect1><tt>.HIBYTES</tt><label id=".HIBYTES"><p>
Define byte sized data by extracting only the high byte (that is, bits 8-15) from
each expression. This is equivalent to <tt><ref id=".BYTE" name=".BYTE"></tt> with
the operator '>' prepended to each expression in its list.
Example:
<tscreen><verb>
.lobytes $1234, $2345, $3456, $4567
.hibytes $fedc, $edcb, $dcba, $cba9
</verb></tscreen>
which is equivalent to
<tscreen><verb>
.byte $34, $45, $56, $67
.byte $fe, $ed, $dc, $cb
</verb></tscreen>
Example:
<tscreen><verb>
.define MyTable TableItem0, TableItem1, TableItem2, TableItem3
TableLookupLo: .lobytes MyTable
TableLookupHi: .hibytes MyTable
</verb></tscreen>
which is equivalent to
<tscreen><verb>
TableLookupLo: .byte &lt;TableItem0, &lt;TableItem1, &lt;TableItem2, &lt;TableItem3
TableLookupHi: .byte &gt;TableItem0, &gt;TableItem1, &gt;TableItem2, &gt;TableItem3
</verb></tscreen>
See also: <tt><ref id=".BYTE" name=".BYTE"></tt>,
<tt><ref id=".LOBYTES" name=".LOBYTES"></tt>,
<tt><ref id=".BANKBYTES" name=".BANKBYTES"></tt>
<sect1><tt>.I16</tt><label id=".I16"><p>
@@ -2745,6 +2813,47 @@ Here's a list of all control commands and a description, what they do:
</verb></tscreen>
<sect1><tt>.LOBYTES</tt><label id=".LOBYTES"><p>
Define byte sized data by extracting only the low byte (that is, bits 0-7) from
each expression. This is equivalent to <tt><ref id=".BYTE" name=".BYTE"></tt> with
the operator '<' prepended to each expression in its list.
Example:
<tscreen><verb>
.lobytes $1234, $2345, $3456, $4567
.hibytes $fedc, $edcb, $dcba, $cba9
</verb></tscreen>
which is equivalent to
<tscreen><verb>
.byte $34, $45, $56, $67
.byte $fe, $ed, $dc, $cb
</verb></tscreen>
Example:
<tscreen><verb>
.define MyTable TableItem0, TableItem1, TableItem2, TableItem3
TableLookupLo: .lobytes MyTable
TableLookupHi: .hibytes MyTable
</verb></tscreen>
which is equivalent to
<tscreen><verb>
TableLookupLo: .byte &lt;TableItem0, &lt;TableItem1, &lt;TableItem2, &lt;TableItem3
TableLookupHi: .byte &gt;TableItem0, &gt;TableItem1, &gt;TableItem2, &gt;TableItem3
</verb></tscreen>
See also: <tt><ref id=".BYTE" name=".BYTE"></tt>,
<tt><ref id=".HIBYTES" name=".HIBYTES"></tt>,
<tt><ref id=".BANKBYTES" name=".BANKBYTES"></tt>
<sect1><tt>.LOCAL</tt><label id=".LOCAL"><p>
This command may only be used inside a macro definition. It declares a