1
0
mirror of https://github.com/RevCurtisP/C02.git synced 2024-11-22 01:31:33 +00:00
C02/include/memio.h02
2018-07-18 23:47:50 -04:00

112 lines
3.7 KiB
Plaintext

/*****************+*************************
* memio - Functions to read/write memory *
******************************************/
/* Return Memory File Pointer Contents *
* Args: mp - memory file pointer *
* Returns: Tuple *
memory pointer address LSB *
memory pointer address MSB */
char maddr();
/* Open Memory File *
* Sets starting address to read/write *
* Args: zp - zero page pointer address *
* &a - base address to read/write *
* Returns: memory file pointer *
* 0 if base address is invalid */
char mopen();
/* Close Memory File *
* Writes EOF at current memory byte *
* and cleares memory pointer *
* Args: mp - memory file pointer *
* Returns: 0 if successful *
255 if memory pointer invalid */
char mclose();
/* End of Memory File *
* Checks for EOF in next memory byte *
* Args: mp - memory file pointer *
* Returns: 0 if not at end of file *
255 if end of file reached */
char meof();
/* Memory File Error *
* Checks for valid memory pointer *
* Args: mp - memory file pointer *
* Returns: 0 if successful *
255 if memory pointer invalid */
char merror();
/* Flush File Buffer *
* Writes EOF at current memory byte *
* Args: mp - memory file pointer *
* Returns: 0 if successful *
255 if memory pointer invalid */
char mflush();
/* Read Character from Memory File *
* Args: mp - memory file pointer *
* Returns: ASCII value of character *
* system dependent garbage *
character if past end of file *
255 if memory pointer invalid */
char mgetc();
/* Write Character to Memory File *
* Args: mp - memory file pointer *
* c - ASCII character to write *
* Returns: 0 if successful *
255 if memory pointer invalid */
char mputc();
/* Read String from Memory File *
* Buffers up to 128 characters *
* until C/R or EOF is found *
* Args: mp - memory file pointer *
* &s - string read from memory *
* Returns: Tuple *
* length of string *
* (255 if error during read) *
* last character read */
char mgets();
/* Write String to Memory File *
* Writes up to 128 characters of a *
* null terminated string *
* Args: mp - memory file pointer *
* &s - string to write from *
* Returns: ending position in string *
* 255 if error during write */
char mputs();
/* Write Line to Memory File *
* Write String to File followed by C/R *
* Args: mp - memory file pointer *
* &s - string to print from *
* Returns: ending position in string *
* 255 if error during write */
char mputln();
/* Set Destination Array for fread() *
* Args: &a - Destination array */
void mdst();
/* Read Bytes from Memory File *
* Reads until End of Memory is reached *
* Args: mp - memory file pointer *
* n - number of bytes to read *
* Returns: number of bytes read */
char mread();
/* Set Source Array for fwrite() *
* Args: &a - Source array */
void msrc();
/* Write Bytes to Memory File *
* Args: mp - memory file pointer *
* n - number of bytes to write *
* Returns: number of bytes written */
char mwrite();