GRASS GIS 8 Programmer's Manual  8.5.0dev(2024)-d6dec75dd4
d_listdb.c
Go to the documentation of this file.
1 /*!
2  * \file db/dbmi_driver/d_listdb.c
3  *
4  * \brief DBMI Library (driver) - list databases
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 <stdlib.h>
16 #include <grass/dbmi.h>
17 #include "macros.h"
18 #include "dbstubs.h"
19 
20 /*!
21  \brief List databases
22 
23  \return DB_OK on success
24  \return DB_FAILED on failure
25  */
27 {
28  dbHandle *handles;
29  dbString *path;
30  int npaths;
31  int i, count;
32  int stat;
33 
34  /* arg(s) */
35  DB_RECV_STRING_ARRAY(&path, &npaths);
36 
37  /* call the procedure */
38  stat = db_driver_list_databases(path, npaths, &handles, &count);
39  db_free_string_array(path, npaths);
40 
41  /* send the return code */
42  if (stat != DB_OK) {
44  return DB_OK;
45  }
47 
48  /* send results */
50  for (i = 0; i < count; i++) {
51  DB_SEND_HANDLE(&handles[i]);
52  }
53  db_free_handle_array(handles, count);
54  return DB_OK;
55 }
int db_d_list_databases(void)
List databases.
Definition: d_listdb.c:26
#define DB_OK
Definition: dbmi.h:71
int(* db_driver_list_databases)(dbString *, int, dbHandle **, int *)
void db_free_string_array(dbString *, int)
Free allocated dbString array.
Definition: string.c:163
void db_free_handle_array(dbHandle *, int)
Free array of handles.
Definition: handle.c:91
int count
#define DB_SEND_INT(x)
Definition: macros.h:82
#define DB_RECV_STRING_ARRAY(x, n)
Definition: macros.h:44
#define DB_SEND_HANDLE(x)
Definition: macros.h:126
#define DB_SEND_SUCCESS()
Definition: macros.h:13
#define DB_SEND_FAILURE()
Definition: macros.h:18
Definition: path.h:15