Details | Last modification | View Log | RSS feed
Rev | Author | Line No. | Line |
---|---|---|---|
1 | pmbaty | 1 | /* |
2 | * stdio/physfs abstraction layer 2003-04-02 |
||
3 | * |
||
4 | * Adam D. Moss <adam@gimp.org> <aspirin@icculus.org> |
||
5 | * |
||
6 | * These wrapper macros and functions are designed to allow a program |
||
7 | * to perform file I/O with identical semantics and syntax regardless |
||
8 | * of whether PhysicsFS is being used or not. |
||
9 | */ |
||
10 | #ifndef _ABS_FILE_H |
||
11 | #define _ABS_FILE_H |
||
12 | /* |
||
13 | PLEASE NOTE: This license applies to abs-file.h ONLY (to make it clear that |
||
14 | you may embed this wrapper code within commercial software); PhysicsFS itself |
||
15 | is (at the time of writing) released under a different license with |
||
16 | additional restrictions. |
||
17 | |||
18 | Copyright (C) 2002-2003 Adam D. Moss (the "Author"). All Rights Reserved. |
||
19 | |||
20 | Permission is hereby granted, free of charge, to any person obtaining a copy |
||
21 | of this software and associated documentation files (the "Software"), to deal |
||
22 | in the Software without restriction, including without limitation the rights |
||
23 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell |
||
24 | copies of the Software, and to permit persons to whom the Software is fur- |
||
25 | nished to do so, subject to the following conditions: |
||
26 | |||
27 | The above copyright notice and this permission notice shall be included in |
||
28 | all copies or substantial portions of the Software. |
||
29 | |||
30 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
||
31 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FIT- |
||
32 | NESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE |
||
33 | AUTHOR BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER |
||
34 | IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CON- |
||
35 | NECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. |
||
36 | |||
37 | Except as contained in this notice, the name of the Author of the |
||
38 | Software shall not be used in advertising or otherwise to promote the sale, |
||
39 | use or other dealings in this Software without prior written authorization |
||
40 | from the Author. |
||
41 | */ |
||
42 | |||
43 | #include <stdlib.h> |
||
44 | #include <stdio.h> |
||
45 | |||
46 | /* |
||
47 | * API: |
||
48 | * |
||
49 | * Macro/function use like stdio equivalent... |
||
50 | * -------------- ---------------------------- |
||
51 | * MY_FILETYPE FILE |
||
52 | * MY_OPEN_FOR_READ fopen(..., "rb") |
||
53 | * MY_READ fread(...) |
||
54 | * MY_CLOSE fclose(...) |
||
55 | * MY_GETC fgetc(...) |
||
56 | * MY_GETS fgets(...) |
||
57 | * MY_ATEOF feof(...) |
||
58 | * MY_TELL ftell(...) |
||
59 | * MY_SEEK fseek(..., SEEK_SET) |
||
60 | * MY_REWIND rewind(...) |
||
61 | * MY_SETBUFFER (not a standard for stdio, does nothing there) |
||
62 | */ |
||
63 | |||
64 | /* |
||
65 | * Important DEFINEs: |
||
66 | * It is important to define these consistantly across the various |
||
67 | * compilation modules of your program if you wish to exchange file |
||
68 | * handles between them. |
||
69 | * |
||
70 | * USE_PHYSFS: Define USE_PHYSFS if PhysicsFS is being used; note that if |
||
71 | * you do intend to use PhysicsFS then you will still need to initialize |
||
72 | * PhysicsFS yourself and set up its search-paths. |
||
73 | * |
||
74 | * Optional DEFINEs: |
||
75 | * |
||
76 | * PHYSFS_DEFAULT_READ_BUFFER <bytes>: If set then abs-file.h sets the |
||
77 | * PhysicsFS buffer size to this value whenever you open a file. You |
||
78 | * may over-ride this on a per-filehandle basis by using the |
||
79 | * MY_SETBUFFER() macro (which simply does nothing when not using |
||
80 | * PhysicsFS). If you have not defined this value explicitly then |
||
81 | * abs-file.h will default to the same default buffer size as used by |
||
82 | * stdio if it can be determined, or 8192 bytes otherwise. |
||
83 | */ |
||
84 | #ifndef PHYSFS_DEFAULT_READ_BUFFER |
||
85 | #ifdef BUFSIZ |
||
86 | #define PHYSFS_DEFAULT_READ_BUFFER BUFSIZ |
||
87 | #else |
||
88 | #define PHYSFS_DEFAULT_READ_BUFFER 8192 |
||
89 | #endif |
||
90 | #endif |
||
91 | |||
92 | #ifdef USE_PHYSFS |
||
93 | |||
94 | #include <physfs.h> |
||
95 | #define MY_FILETYPE PHYSFS_File |
||
96 | #define MY_SETBUFFER(fp,size) PHYSFS_setBuffer(fp,size) |
||
97 | #define MY_READ(p,s,n,fp) PHYSFS_read(fp,p,s,n) |
||
98 | #if PHYSFS_DEFAULT_READ_BUFFER |
||
99 | static MY_FILETYPE* MY_OPEN_FOR_READ(const char *const filename) |
||
100 | { |
||
101 | MY_FILETYPE *const file = PHYSFS_openRead(filename); |
||
102 | if (file) { |
||
103 | MY_SETBUFFER(file, PHYSFS_DEFAULT_READ_BUFFER); |
||
104 | } |
||
105 | return file; |
||
106 | } |
||
107 | #else |
||
108 | #define MY_OPEN_FOR_READ(fn) PHYSFS_openRead(fn) |
||
109 | #endif |
||
110 | static int MY_GETC(MY_FILETYPE *const fp) { |
||
111 | unsigned char c; |
||
112 | /*if (PHYSFS_eof(fp)) { |
||
113 | return EOF; |
||
114 | } |
||
115 | MY_READ(&c, 1, 1, fp);*/ |
||
116 | if (MY_READ(&c, 1, 1, fp) != 1) { |
||
117 | return EOF; |
||
118 | } |
||
119 | return c; |
||
120 | } |
||
121 | static char * MY_GETS(char * const str, const int size, |
||
122 | MY_FILETYPE *const fp) { |
||
123 | int i = 0; |
||
124 | int c; |
||
125 | do { |
||
126 | if (i == size-1) { |
||
127 | break; |
||
128 | } |
||
129 | c = MY_GETC(fp); |
||
130 | if (c == EOF) { |
||
131 | break; |
||
132 | } |
||
133 | str[i++] = c; |
||
134 | } while (c != '\0' && |
||
135 | c != -1 && |
||
136 | c != '\n'); |
||
137 | str[i] = '\0'; |
||
138 | if (i == 0) { |
||
139 | return NULL; |
||
140 | } |
||
141 | return str; |
||
142 | } |
||
143 | #define MY_CLOSE(fp) PHYSFS_close(fp) |
||
144 | #define MY_ATEOF(fp) PHYSFS_eof(fp) |
||
145 | #define MY_TELL(fp) PHYSFS_tell(fp) |
||
146 | #define MY_SEEK(fp,o) PHYSFS_seek(fp,o) |
||
147 | #define MY_REWIND(fp) MY_SEEK(fp,0) |
||
148 | |||
149 | #else |
||
150 | |||
151 | #define MY_FILETYPE FILE |
||
152 | #define MY_READ(p,s,n,fp) fread(p,s,n,fp) |
||
153 | #define MY_OPEN_FOR_READ(n) fopen(n, "rb") |
||
154 | #define MY_GETC(fp) fgetc(fp) |
||
155 | #define MY_GETS(str,size,fp) fgets(str,size,fp) |
||
156 | #define MY_CLOSE(fp) fclose(fp) |
||
157 | #define MY_ATEOF(fp) feof(fp) |
||
158 | #define MY_TELL(fp) ftell(fp) |
||
159 | #define MY_SEEK(fp,o) fseek(fp,o, SEEK_SET) |
||
160 | #define MY_REWIND(fp) rewind(fp) |
||
161 | /*static void MY_SETBUFFER(const MY_FILETYPE *const file, const int num) { }*/ |
||
162 | #define MY_SETBUFFER(fp,size) |
||
163 | #endif |
||
164 | |||
165 | #endif |