1/*****************************************************************************/
2/* */
3/* fileio.h */
4/* */
5/* File I/O for the ld65 linker */
6/* */
7/* */
8/* */
9/* (C) 1998-2003 Ullrich von Bassewitz */
10/* Roemerstrasse 52 */
11/* D-70794 Filderstadt */
12/* EMail: uz@cc65.org */
13/* */
14/* */
15/* This software is provided 'as-is', without any expressed or implied */
16/* warranty. In no event will the authors be held liable for any damages */
17/* arising from the use of this software. */
18/* */
19/* Permission is granted to anyone to use this software for any purpose, */
20/* including commercial applications, and to alter it and redistribute it */
21/* freely, subject to the following restrictions: */
22/* */
23/* 1. The origin of this software must not be misrepresented; you must not */
24/* claim that you wrote the original software. If you use this software */
25/* in a product, an acknowledgment in the product documentation would be */
26/* appreciated but is not required. */
27/* 2. Altered source versions must be plainly marked as such, and must not */
28/* be misrepresented as being the original software. */
29/* 3. This notice may not be removed or altered from any source */
30/* distribution. */
31/* */
32/*****************************************************************************/
33
34
35
36#ifndef FILEIO_H
37#define FILEIO_H
38
39
40
41#include <stdio.h>
42
43/* common */
44#include "filepos.h"
45
46
47
48/*****************************************************************************/
49/* Code */
50/*****************************************************************************/
51
52
53
54void FileSetPos (FILE* F, unsigned long Pos);
55/* Seek to the given absolute position, fail on errors */
56
57unsigned long FileGetPos (FILE* F);
58/* Return the current file position, fail on errors */
59
60void Write8 (FILE* F, unsigned Val);
61/* Write an 8 bit value to the file */
62
63void Write16 (FILE* F, unsigned Val);
64/* Write a 16 bit value to the file */
65
66void Write24 (FILE* F, unsigned long Val);
67/* Write a 24 bit value to the file */
68
69void Write32 (FILE* F, unsigned long Val);
70/* Write a 32 bit value to the file */
71
72void WriteVal (FILE* F, unsigned long Val, unsigned Size);
73/* Write a value of the given size to the output file */
74
75void WriteVar (FILE* F, unsigned long V);
76/* Write a variable sized value to the file in special encoding */
77
78void WriteStr (FILE* F, const char* S);
79/* Write a string to the file */
80
81void WriteData (FILE* F, const void* Data, unsigned Size);
82/* Write data to the file */
83
84void WriteMult (FILE* F, unsigned char Val, unsigned long Count);
85/* Write one byte several times to the file */
86
87unsigned Read8 (FILE* F);
88/* Read an 8 bit value from the file */
89
90unsigned Read16 (FILE* F);
91/* Read a 16 bit value from the file */
92
93unsigned long Read24 (FILE* F);
94/* Read a 24 bit value from the file */
95
96unsigned long Read32 (FILE* F);
97/* Read a 32 bit value from the file */
98
99long Read32Signed (FILE* F);
100/* Read a 32 bit value from the file. Sign extend the value. */
101
102unsigned long ReadVar (FILE* F);
103/* Read a variable size value from the file */
104
105unsigned ReadStr (FILE* F);
106/* Read a string from the file, place it into the global string pool, and
107** return its string id.
108*/
109
110FilePos* ReadFilePos (FILE* F, FilePos* Pos);
111/* Read a file position from the file */
112
113void* ReadData (FILE* F, void* Data, unsigned Size);
114/* Read data from the file */
115
116
117
118/* End of fileio.h */
119
120#endif
121