GRASS GIS 8 Programmer's Manual
8.5.0dev(2024)-57a646b4a4
c_fetch.c
Go to the documentation of this file.
1
/*!
2
* \file db/dbmi_client/c_fetch.c
3
*
4
* \brief DBMI Library (client) - fetch data
5
*
6
* (C) 1999-2008 by the GRASS Development Team
7
*
8
* This program is free software under the GNU General Public
9
* License (>=v2). Read the file COPYING that comes with GRASS
10
* for details.
11
*
12
* \author Joel Jones (CERL/UIUC), Radim Blazek
13
*/
14
15
#include <
grass/dbmi.h
>
16
#include "
macros.h
"
17
18
/*!
19
\brief Fetch data from open cursor
20
21
\param cursor pointer to dbCursor
22
\param position cursor position
23
\param[out] more get more (0 for no data to be fetched)
24
25
\return DB_OK on success
26
\return DB_FAILED on failure
27
*/
28
int
db_fetch
(
dbCursor
*cursor,
int
position,
int
*more)
29
{
30
int
ret_code;
31
32
/* start the procedure call */
33
db__set_protocol_fds
(cursor->
driver
->
send
, cursor->
driver
->
recv
);
34
DB_START_PROCEDURE_CALL
(
DB_PROC_FETCH
);
35
36
/* send the argument(s) to the procedure */
37
DB_SEND_TOKEN
(&cursor->
token
);
38
DB_SEND_INT
(position);
39
40
/* get the return code for the procedure call */
41
DB_RECV_RETURN_CODE
(&ret_code);
42
43
if
(ret_code !=
DB_OK
)
44
return
ret_code;
/* ret_code SHOULD == DB_FAILED */
45
46
/* get the results */
47
DB_RECV_INT
(more);
48
if
(*more) {
49
DB_RECV_TABLE_DATA
(cursor->
table
);
50
}
51
return
DB_OK
;
52
}
db_fetch
int db_fetch(dbCursor *cursor, int position, int *more)
Fetch data from open cursor.
Definition:
c_fetch.c:28
dbmi.h
DB_PROC_FETCH
#define DB_PROC_FETCH
Definition:
dbmi.h:39
DB_OK
#define DB_OK
Definition:
dbmi.h:71
db__set_protocol_fds
void db__set_protocol_fds(FILE *, FILE *)
?
Definition:
db/dbmi_base/xdr.c:75
macros.h
DB_SEND_INT
#define DB_SEND_INT(x)
Definition:
macros.h:82
DB_RECV_TABLE_DATA
#define DB_RECV_TABLE_DATA(x)
Definition:
macros.h:153
DB_RECV_INT
#define DB_RECV_INT(x)
Definition:
macros.h:87
DB_START_PROCEDURE_CALL
#define DB_START_PROCEDURE_CALL(x)
Definition:
macros.h:2
DB_RECV_RETURN_CODE
#define DB_RECV_RETURN_CODE(x)
Definition:
macros.h:7
DB_SEND_TOKEN
#define DB_SEND_TOKEN(x)
Definition:
macros.h:214
_db_cursor
Definition:
dbmi.h:221
_db_cursor::driver
dbDriver * driver
Definition:
dbmi.h:223
_db_cursor::table
dbTable * table
Definition:
dbmi.h:224
_db_cursor::token
dbToken token
Definition:
dbmi.h:222
_db_driver::recv
FILE * recv
Definition:
dbmi.h:167
_db_driver::send
FILE * send
Definition:
dbmi.h:167
lib
db
dbmi_client
c_fetch.c
Generated on Wed Dec 25 2024 07:30:17 for GRASS GIS 8 Programmer's Manual by
1.9.1