-
Notifications
You must be signed in to change notification settings - Fork 0
/
cursor.h
408 lines (342 loc) · 10.4 KB
/
cursor.h
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
#ifndef _CURSOR_H_
#define _CURSOR_H_
#include "common.h"
#include "cursor_window.h"
typedef struct _Cursor Cursor;
/**
virtual function list
*/
/**
destroy
*/
typedef BOOL (*CursorOnDestroy)(Cursor* thiz);
/**
delete
*/
typedef BOOL (*CursorDeleteRow)(Cursor* thiz,INT32 row);
/**
update
*/
typedef BOOL (*CursorUpdateINT)(Cursor* cursor,INT32 row,INT32 col,INT64 value);
typedef BOOL (*CursorUpdateString)(Cursor* cursor,INT32 row,INT32 col,const CHAR* value);
typedef BOOL (*CursorUpdateString16)(Cursor* cursor,INT32 row,INT32 col,const WCHAR* value);
typedef BOOL (*CursorUpdateBool)(Cursor* cursor,INT32 row,INT32 col,BOOL value);
typedef BOOL (*CursorUpdateBlob)(Cursor* cursor,INT32 row,INT32 col,UINT8* value,INT32 len);
typedef BOOL (*CursorUpdateDouble)(Cursor* cursor,INT32 row,INT32 col,double value);
typedef const CHAR* (*CursorGetString)(const Cursor* cursor,INT32 column_index);
typedef const WCHAR* (*CursorGetString16)(const Cursor* cursor,INT32 column_index);
struct _Cursor
{
CursorWindow* data_win;
CursorWindow* name_win;
INT32 cur_row;
BOOL read_only;
/**
destroy
*/
CursorOnDestroy on_destroy;
/**
delete
*/
CursorDeleteRow delete_row;
/**
update
*/
CursorUpdateINT update_int;
CursorUpdateString update_string;
CursorUpdateString16 update_string16;
CursorUpdateBool update_bool;
CursorUpdateBlob update_blobl;
CursorUpdateDouble update_double;
/**
for db special string proces, need to make the get string functions as virtual funtions
*/
CursorGetString get_string;
CursorGetString16 get_string_16;
void* priv_subclass;
};
/**
* @brief create a cursor
* @param[in] col_num colume number
* @param[in] read_only read only or not
* @return Cursor instance
*/
extern Cursor* cursor_create(INT32 col_num,BOOL read_only);
/**
* @brief get data window
* @param[in] thiz Cursor handle
* @return CursorWindow instance
*/
extern CursorWindow* cursor_get_data_window(Cursor* thiz);
/**
* @brief get name window
* @param[in] thiz Cursor handle
* @return CursorWindow instance
*/
extern CursorWindow* cursor_get_name_window(Cursor* thiz) ;
/**
* @brief destroy cursor, the name window and data window will be destoried
* @param[in] thiz Cursor handle
*/
extern void cursor_destroy(Cursor* cursor);
/**
* @brief get count in data window
* @param[in] thiz Cursor handle
* @return count
*/
extern INT32 cursor_get_count(Cursor* cursor);
/**
* @brief get count in name window
* @param[in] thiz Cursor handle
* @return count
*/
extern INT32 cursor_get_column_num(Cursor* cursor);
/**
* @brief get colume index
* @param[in] thiz Cursor handle
* @param[in] col_name colume name
* @return index
*/
extern INT32 cursor_get_column_index(Cursor* cursor,const CHAR* col_name);
/**
* @brief get colume name
* @param[in] thiz Cursor handle
* @param[in] col colume index
* @return colume name
*/
extern const CHAR* cursor_get_column_name( Cursor* cursor,INT32 col);
/**
* @brief set colume name
* @param[in] thiz Cursor handle
* @param[in] col colume index
* @param[in] col_name colume name
* @return error code
*/
extern BOOL cursor_set_column_name( Cursor* cursor,INT32 col,const CHAR* col_name);
/**
* @brief get current position
* @param[in] thiz Cursor handle
* @return position
*/
extern INT32 cursor_get_position( Cursor* cursor);
/**
* @brief move to first
* @param[in] thiz Cursor handle
* @return error code
*/
extern BOOL cursor_move_to_first(Cursor* cursor);
/**
* @brief move to last
* @param[in] thiz Cursor handle
* @return error code
*/
extern BOOL cursor_move_to_last(Cursor* cursor);
/**
* @brief move to next
* @param[in] thiz Cursor handle
* @return error code
*/
extern BOOL cursor_move_to_next(Cursor* cursor);
/**
* @brief move to previous
* @param[in] thiz Cursor handle
* @return error code
*/
extern BOOL cursor_move_to_previous(Cursor* cursor);
/**
* @brief move to given position
* @param[in] thiz Cursor handle
* @param[in] pos position
* @return error code
*/
extern BOOL cursor_move_to_position(Cursor* cursor,INT32 pos);
/**
* @brief whether or not current is last position
* @param[in] thiz Cursor handle
* @return bool code
*/
extern BOOL cursor_is_last(const Cursor* cursor);
/**
* @brief whether or not current is first position
* @param[in] thiz Cursor handle
* @return bool code
*/
extern BOOL cursor_is_first(const Cursor* cursor);
/**
* @brief get int64 value
*
* @param[in] thiz ContentValues handle
* @param[in] column_index colume index
* @param[out] value save int value
* @return error code
*/
extern BOOL cursor_get_int(const Cursor* cursor,INT32 column_index,INT64* value);
/**
* @brief get bool value
*
* @param[in] thiz ContentValues handle
* @param[in] column_index colume index
* @param[out] value save bool value
* @return error code
*/
extern BOOL cursor_get_bool(const Cursor* cursor,INT32 column_index,BOOL* value);
/**
* @brief get double value
*
* @param[in] thiz ContentValues handle
* @param[in] column_index colume index
* @param[out] value save double value
* @return error code
*/
extern BOOL cursor_get_double(const Cursor* cursor,INT32 column_index,double* value);
/**
* @brief get string value
*
* @param[in] thiz ContentValues handle
* @param[in] column_index colume index
* @return string value
*/
extern const CHAR* cursor_get_string(const Cursor* cursor,INT32 column_index);
/**
* @brief get wstring value
*
* @param[in] thiz ContentValues handle
* @param[in] column_index colume index
* @return wstring value
*/
extern const WCHAR* cursor_get_string_16(const Cursor* cursor,INT32 column_index);
/**
* @brief get blob value
*
* @param[in] thiz ContentValues handle
* @param[in] column_index colume index
* @param[out] data colume save blob data, do not need to release the buffer
* @param[out] output_len blob data lenght
* @return wstring value
*/
extern BOOL cursor_get_blob(const Cursor* cursor,INT32 column_index,void** data,INT32* output_len);
/**
* @brief whether or not the given colume is null
*
* @param[in] thiz ContentValues handle
* @param[in] column_index colume index
* @return bool code
*/
extern BOOL cursor_is_null(const Cursor* cursor,INT32 column_index);
/**
* @brief whether or not the given colume is int
*
* @param[in] thiz ContentValues handle
* @param[in] column_index colume index
* @return bool code
*/
extern BOOL cursor_is_int(const Cursor* cursor,INT32 column_index);
/**
* @brief whether or not the given colume is bool
*
* @param[in] thiz ContentValues handle
* @param[in] column_index colume index
* @return bool code
*/
extern BOOL cursor_is_bool(const Cursor* cursor,INT32 column_index);
/**
* @brief whether or not the given colume is double
*
* @param[in] thiz ContentValues handle
* @param[in] column_index colume index
* @return bool code
*/
extern BOOL cursor_is_double (const Cursor* cursor,INT32 column_index);
/**
* @brief whether or not the given colume is string
*
* @param[in] thiz ContentValues handle
* @param[in] column_index colume index
* @return bool code
*/
extern BOOL cursor_is_string (const Cursor* cursor,INT32 column_index);
/**
* @brief whether or not the given colume is wstring
*
* @param[in] thiz ContentValues handle
* @param[in] column_index colume index
* @return bool code
*/
extern BOOL cursor_is_string_16 (const Cursor* cursor,INT32 column_index);
/**
* @brief whether or not the given colume is blob
*
* @param[in] thiz ContentValues handle
* @param[in] column_index colume index
* @return bool code
*/
extern BOOL cursor_is_blob (const Cursor* cursor,INT32 column_index);
/**
* @brief update int value
*
* @param[in] thiz ContentValues handle
* @param[in] row row index
* @param[in] col colume index
* @param[in] value int value
* @return bool code
*/
extern BOOL cursor_update_int(Cursor* cursor,INT32 row,INT32 col,INT64 value);
/**
* @brief update bool value
*
* @param[in] thiz ContentValues handle
* @param[in] row row index
* @param[in] col colume index
* @param[in] value bool value
* @return bool code
*/
extern BOOL cursor_update_bool(Cursor* cursor,INT32 row,INT32 col,BOOL value);
/**
* @brief update double value
*
* @param[in] thiz ContentValues handle
* @param[in] row row index
* @param[in] col colume index
* @param[in] value double value
* @return bool code
*/
extern BOOL cursor_update_double(Cursor* cursor,INT32 row,INT32 col,double value);
/**
* @brief update string value
*
* @param[in] thiz ContentValues handle
* @param[in] row row index
* @param[in] col colume index
* @param[in] value string value
* @return bool code
*/
extern BOOL cursor_update_string(Cursor* cursor,INT32 row,INT32 col,const CHAR* value);
/**
* @brief update wstring value
*
* @param[in] thiz ContentValues handle
* @param[in] row row index
* @param[in] col colume index
* @param[in] value wstring value
* @return bool code
*/
extern BOOL cursor_update_string_16(Cursor* cursor,INT32 row,INT32 col,const WCHAR* value);
/**
* @brief update blob value
*
* @param[in] thiz ContentValues handle
* @param[in] row row index
* @param[in] col colume index
* @param[in] value blob value
* @return bool code
*/
extern BOOL cursor_update_blob(Cursor* cursor,INT32 row,INT32 col,UINT8* value,INT32 len);
/**
* @brief delete row
*
* @param[in] thiz ContentValues handle
* @param[in] row row index
* @return bool code
*/
extern BOOL cursor_delete_row(Cursor* cursor,INT32 row);
#endif