mirror of
https://github.com/RevCurtisP/C02.git
synced 2024-06-01 05:41:34 +00:00
259 lines
13 KiB
Plaintext
259 lines
13 KiB
Plaintext
Extended Input/Output Functions for C02 Programs
|
|
|
|
At the beginning of the program use the directives
|
|
|
|
#include <stddef.h02>
|
|
#include <stdlib.h02>
|
|
#include <intlib.h02>
|
|
#include <stdiox.h02>
|
|
|
|
The following functions are defined:
|
|
|
|
c = getcpr(s); Writes the string s to the screen, waits for a key
|
|
to be pressed, then writes a blank line line.
|
|
|
|
Returns the ASCII value of the key that was
|
|
pressed.
|
|
|
|
Note: Calls the puts() function, the newlin()
|
|
function twice, then the getc function.
|
|
|
|
c = anykey(); Writes the string "Press any key to continue...",
|
|
followed by a blank line to the screen, then waits
|
|
for a key to be pressed.
|
|
|
|
Returns the ASCII value of the key that was
|
|
pressed.
|
|
|
|
Note: Calls the getprc() function, with a hard
|
|
coded string.
|
|
|
|
putspc(b); Writes a space character to the screen.
|
|
|
|
Note: Used by the putdel(), putder(), and putinj()
|
|
functions.
|
|
|
|
putrpt(c,n); Writes character c to the screen n times.
|
|
|
|
Note: Repeatedly calls putc().
|
|
|
|
putrps(n); Writes a space to the screen n times.
|
|
|
|
Note: Calls putrpt() with a space character.
|
|
|
|
putdec(b); Writes the decimal representation of byte b to the
|
|
screen. The output will be between one and three
|
|
digits with no leading spaces.
|
|
|
|
Note: Calls part of the ctoa routine from stdlib
|
|
which leaves the binary values of the ones, tens,
|
|
and hundreds digits in variables temp0, temp1, and
|
|
temp2, respectively. Called by printf() when
|
|
processing the %D formatting tag.
|
|
|
|
putdel(b); Writes the decimal representation of byte b to the
|
|
screen. The output is left justified by appending it
|
|
with 1 space if b is between 10 and 99, or two spaces
|
|
if b is less than 10.
|
|
|
|
Note: Calls putdec() and putspc(). Leaves the value
|
|
of b in variable temp3. Called by printf() when
|
|
processing the %L formatting tag.
|
|
|
|
putder(b); Writes the decimal representation of byte b to
|
|
the screen. The output is right justified by left
|
|
padding it with 1 space if b is between 10 and 99,
|
|
or two spaces if b is less than 10.
|
|
|
|
Note: Calls putdec() and putspc(). Leaves the value
|
|
of b in variable temp3. Called by printf() when
|
|
processing the %R formatting tag.
|
|
|
|
putdez(b); Writes the decimal representation of byte b to the
|
|
screen. The output is always three digits, including
|
|
leading zeros.
|
|
|
|
Note: Calls part of the ctoa() routine from stdlib
|
|
which leaves the binary values of the ones, tens,
|
|
and hundreds digits in variables temp0, temp1, and
|
|
temp2, respectively. Called by printf() when
|
|
processing the %Z formatting tag.
|
|
|
|
putdeh(b); Writes the decimal representation of byte b, modulo
|
|
100, to the screen. The output is always two digits,
|
|
the ten's digit and the one's digit.
|
|
|
|
Note: Calls part of the ctoa routine from stdlib
|
|
which leaves the binary values of the ones, tens,
|
|
and hundreds digits in variables temp0, temp1, and
|
|
temp2, respectively. Called by printf() when
|
|
processing the %H formatting tag.
|
|
|
|
putbin(b); Writes the binary representation of byte b to the
|
|
screen. The output is always eight binary digits
|
|
(0 or 1).
|
|
|
|
Note: Calls putmsk() with a mask of $FF. Called
|
|
by printf() when processing the %B formatting tag.
|
|
|
|
putexh(b,i); Writes the hexadecimal representation of a 24-bit
|
|
number to the screen, where b is the high byte and
|
|
i is the middle and low bytes. The output is always
|
|
six hex digits, with leading zeros if b is less than
|
|
$10.
|
|
|
|
Note: Calls savrxy(), saving the X and Y registers
|
|
to temp1 and temp2, respectively, then calls puthex()
|
|
to print the highest byte and putwrd() to print the
|
|
middle and low bytes.
|
|
|
|
puthex(b); Writes the hexadecimal representation of byte b to the
|
|
screen. The output is always two hex digits, the first
|
|
being a leading 0 if b is less than 16. Called by
|
|
printf() when processing the %X formatting tag.
|
|
|
|
Note: Aliased to the prbyte() routine.
|
|
|
|
putint(i); Writes the decimal representation of integer i to the
|
|
screen. The output will be one to five decimal digits,
|
|
with no leading zeros or padding.
|
|
|
|
Note: Calls cvibcd, then calls upbcdi for each digit
|
|
to be printed. Called by printf() when processing
|
|
the %I formatting tag.
|
|
|
|
putinr(i); Writes the decimal representation of integer i to the
|
|
screen. The output is always five charactes. right
|
|
justified by left padding it with spaces.
|
|
|
|
Note: Calls putint(). Called by printf() when
|
|
processing the %J formatting tag.
|
|
|
|
putnyb(b); Writes the hexadecimal representation of the low
|
|
nybble of byte b to the screen. The output is always
|
|
one hex digit (0-F).
|
|
|
|
Note: Aliased to the prhex() routine. Called by
|
|
printf() when processing the %W formatting tag.
|
|
|
|
putmsk(b,m); Writes the binary representation of each of the bits
|
|
in byte b for which the corresponding bit of m is set.
|
|
The output will be between 0 and 8 binary digits,
|
|
depending on how many bits of m are set.
|
|
|
|
putmsk(b,$0F); //Print Low Nybble as Binary Number
|
|
putmsk(b,$81); //Print Highest and Lowest Bits
|
|
|
|
putsqb(i); Writes the hexadecimal representation of the twelve
|
|
lowest bits of i (a sesquibyte) to the screen. The
|
|
output is always three hex digits, with leading
|
|
zeros if i is less than $0100.
|
|
|
|
Note: Calls savrxy(), saving the X and Y registers to
|
|
temp1 and temp2, respectively, then calls putnyb for
|
|
the most significant byte and puthex() for the least
|
|
significant byte. Called by printf() when processing
|
|
the %Q formatting tag.
|
|
|
|
putwrd(i); Writes the hexadecimal representation of integer i to
|
|
the screen. The output is always four hex digits, with
|
|
leading zeros if i is less than $1000.
|
|
|
|
Note: Calls savrxy(), saving the X and Y registers to
|
|
temp1 and temp2, respectively, then calls puthex, once
|
|
for the most significant byte and again for the least
|
|
significant byte. Called by printf() when processing
|
|
the %W formatting tag.
|
|
|
|
putdst(); Prints the destination string set by the setdst or
|
|
setstr functions.
|
|
|
|
This can be used to print the results of any function
|
|
call that stores it's result in the destination string,
|
|
such as strcat, strcpy, and strcut in string,
|
|
|
|
Note: calls putc. Called by printf() when processing
|
|
the %S formatting tag.
|
|
|
|
r = printf(b, &s): Writes the value of byte b to screen, formatting
|
|
the output according the contents of string s.
|
|
|
|
The output consists of the characters in s, but
|
|
with any formatting tags (which may be upper or
|
|
lower case) replaced with an ASCII representation
|
|
of the value of b.
|
|
|
|
The recognized formatting tags are:
|
|
%B - output b as an eight-digit binary number
|
|
%C - output the ASCII character represented by b
|
|
%D - output b as a an unjustified decimal number
|
|
%H - output b as a modulo-100 decimal number
|
|
%L - output b as a left justified decimal number
|
|
%R - output b as a right justified decimal number
|
|
%X - output b as a two-digit hexadecimal number
|
|
%Y - output low nybble of b as a hexadecimal digit
|
|
%Z - output b as a zero-filled decimal number
|
|
|
|
Unlike the printf() function in standard C, only
|
|
one value argument may be passed and that value is
|
|
used for each formatting tag in the format string.
|
|
|
|
Two special function tags are supported:
|
|
%% - output a single % character
|
|
%N - generate a newline
|
|
|
|
Additional formatting tags operate on the
|
|
destination pointer:
|
|
%S - output destination string
|
|
%P - output destination string padded with
|
|
spaces to length b
|
|
%I - output destination address as one to
|
|
five digit decimal number
|
|
%J - output destination address as right
|
|
justified decimal number
|
|
%Q - output destination address as
|
|
three-digit hexadecimal number
|
|
%W - output destination address as
|
|
four-digit hexadecimal number
|
|
%E - output b and destination address as
|
|
six-digit hexadecimal number
|
|
|
|
The destination string and/or address is set using
|
|
the setdst or strdst function (from the "string"
|
|
library) before calling printf. Multiple occurrences
|
|
of the %S or %w tag will cause the destination string
|
|
and/or address to be repeated.
|
|
|
|
When tag types are mixed, the %S and/or %W tags will
|
|
output the destination string and/or address, while
|
|
the other tags will output the formatted byte. If
|
|
only the %S and/or %W tags are used, then the byte
|
|
argument may be excluded from the call.
|
|
|
|
The letter in the formatting tag may be upper or
|
|
lower case with either a 0 or 1 in the high bit.
|
|
Unrecognized formatting tags are interpreted as %C.
|
|
|
|
Note: Calls putdec, putdel, putder, puthex, putint,
|
|
putwrd, or putdst depending on which formatting tags
|
|
are used. The value of b is left in variable temp3.
|
|
|
|
Note: This library expects the following functions to be defined:
|
|
|
|
cubcd(); Convert byte to BCD and unpack into three bytes
|
|
cvibcd(); Convert Integer to Binary Coded Decimal
|
|
prbyte(); Print byte to screen as hexadecimal number
|
|
prchr(); Print ASCII character to screen
|
|
savrxy()(); Save X and Y registers.
|
|
setsrc(); Set source string pointer and initialize index
|
|
upbcdi(); Unpack digit from Binary Coded Decimal Integer
|
|
|
|
along with the zero page variable pairs:
|
|
|
|
srclo,srchi: Source Pointer
|
|
dstlo,dsthi: Destination Pointer
|
|
|
|
and the temporary variables
|
|
|
|
temp0,temp1,temp2,temp3
|