libopc
file.h
Go to the documentation of this file.
1 /*
2  Copyright (c) 2010, Florian Reuter
3  All rights reserved.
4 
5  Redistribution and use in source and binary forms, with or without
6  modification, are permitted provided that the following conditions
7  are met:
8 
9  * Redistributions of source code must retain the above copyright
10  notice, this list of conditions and the following disclaimer.
11  * Redistributions in binary form must reproduce the above copyright
12  notice, this list of conditions and the following disclaimer in
13  the documentation and/or other materials provided with the
14  distribution.
15  * Neither the name of Florian Reuter nor the names of its contributors
16  may be used to endorse or promote products derived from this
17  software without specific prior written permission.
18 
19  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
20  "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
21  LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
22  FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
23  COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
24  INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
25  BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
26  LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
27  CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
28  STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
29  ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
30  OF THE POSSIBILITY OF SUCH DAMAGE.
31 
32 */
36 #include <opc/config.h>
37 
38 #ifndef OPC_FILE_H
39 #define OPC_FILE_H
40 
41 #ifdef __cplusplus
42 extern "C" {
43 #endif
44 
49 #define OPC_FILE_READ (1<<0)
50 
55 #define OPC_FILE_WRITE (1<<1)
56 
61 #define OPC_FILE_TRUNC (1<<2)
62 
63 
67  typedef enum OPC_FILESEEKMODE_ENUM {
68  opcFileSeekSet = SEEK_SET,
69  opcFileSeekCur = SEEK_CUR,
70  opcFileSeekEnd = SEEK_END
72 
81  typedef int opcFileReadCallback(void *iocontext, char *buffer, int len);
82 
91  typedef int opcFileWriteCallback(void *iocontext, const char *buffer, int len);
92 
101  typedef int opcFileCloseCallback(void *iocontext);
102 
116  typedef opc_ofs_t opcFileSeekCallback(void *iocontext, opc_ofs_t ofs);
117 
130  typedef int opcFileTrimCallback(void *iocontext, opc_ofs_t new_size);
131 
140  typedef int opcFileFlushCallback(void *iocontext);
141 
145  typedef struct OPC_FILERAWSTATE_STRUCT {
146  opc_error_t err;
147  opc_ofs_t buf_pos; // current pos in file
148  } opcFileRawState;
149 
153  typedef struct OPC_IO_STRUCT {
154  opcFileReadCallback *_ioread;
155  opcFileWriteCallback *_iowrite;
156  opcFileCloseCallback *_ioclose;
157  opcFileSeekCallback *_ioseek;
158  opcFileTrimCallback *_iotrim;
159  opcFileFlushCallback *_ioflush;
160  void *iocontext;
161  int flags;
162  opcFileRawState state;
163  opc_ofs_t file_size;
164  } opcIO_t;
165 
170  opcFileReadCallback *ioread,
171  opcFileWriteCallback *iowrite,
172  opcFileCloseCallback *ioclose,
173  opcFileSeekCallback *ioseek,
174  opcFileTrimCallback *iotrim,
175  opcFileFlushCallback *ioflush,
176  void *iocontext,
177  pofs_t file_size,
178  int flags);
179 
183  opc_error_t opcFileInitIOFile(opcIO_t *io, const xmlChar *filename, int flags);
184 
189  opc_error_t opcFileInitIOMemory(opcIO_t *io, const opc_uint8_t *data, opc_uint32_t data_len, int flags);
190 
195 
196 #ifdef __cplusplus
197 } /* extern "C" */
198 #endif
199 
200 #endif /* OPC_FILE_H */
int opcFileReadCallback(void *iocontext, char *buffer, int len)
Definition: file.h:81
int opcFileCloseCallback(void *iocontext)
Definition: file.h:101
puint8_t opc_uint8_t
Definition: config.h:91
opc_error_t opcFileInitIOFile(opcIO_t *io, const xmlChar *filename, int flags)
Definition: file.c:191
struct OPC_IO_STRUCT opcIO_t
int opcFileTrimCallback(void *iocontext, opc_ofs_t new_size)
Definition: file.h:130
puint32_t opc_uint32_t
Definition: config.h:103
opc_error_t opcFileInitIO(opcIO_t *io, opcFileReadCallback *ioread, opcFileWriteCallback *iowrite, opcFileCloseCallback *ioclose, opcFileSeekCallback *ioseek, opcFileTrimCallback *iotrim, opcFileFlushCallback *ioflush, void *iocontext, pofs_t file_size, int flags)
Definition: file.c:168
opc_error_t opcFileInitIOMemory(opcIO_t *io, const opc_uint8_t *data, opc_uint32_t data_len, int flags)
Definition: file.c:212
enum OPC_ERROR_ENUM opc_error_t
pofs_t opc_ofs_t
Definition: config.h:85
opc_ofs_t opcFileSeekCallback(void *iocontext, opc_ofs_t ofs)
Definition: file.h:116
opc_error_t opcFileCleanupIO(opcIO_t *io)
Definition: file.c:233
int opcFileFlushCallback(void *iocontext)
Definition: file.h:140
enum OPC_FILESEEKMODE_ENUM opcFileSeekMode
Definition: file.h:153
int opcFileWriteCallback(void *iocontext, const char *buffer, int len)
Definition: file.h:91
Definition: file.h:145
struct OPC_FILERAWSTATE_STRUCT opcFileRawState
OPC_FILESEEKMODE_ENUM
Definition: file.h:67