dbapi2/dbapi2.h

   1 #ifndef __DBAPI2_H
   2 #define __DBAPI2_H
   3
   4 #define DBNAME_LEN 100
   5
   6 #include "../config.h"
   7
   8 #define DBAPI2_DEFAULT NULL
   9
  10 #include <stdlib.h>
  11 #include <stdarg.h>
  12
  13 struct DBAPIConn;
  14
  15 #ifndef DBAPI2_HANDLE
  16 #define DBAPI2_HANDLE void
  17 #endif
  18
  19 #ifndef DBAPI2_RESULT_HANDLE
  20 #define DBAPI2_RESULT_HANDLE void
  21 #endif
  22
  23 typedef void *DBAPIUserData;
  24
  25 struct DBAPIResult;
  26
  27 typedef DBAPI2_HANDLE *(*DBAPINew)(const struct DBAPIConn *);
  28 typedef void (*DBAPIClose)(struct DBAPIConn *);
  29
  30 typedef void (*DBAPIQueryCallback)(const struct DBAPIResult *, void *);
  31
  32 typedef void (*DBAPIQuery)(const struct DBAPIConn *, DBAPIQueryCallback, DBAPIUserData, const char *, ...) __attribute__ ((format (printf, 4, 5)));
  33 typedef void (*DBAPISimpleQuery)(const struct DBAPIConn *, const char *, ...) __attribute__ ((format (printf, 2, 3)));
  34 typedef void (*DBAPIQueryV)(const struct DBAPIConn *, DBAPIQueryCallback, DBAPIUserData, const char *);
  35 typedef void (*DBAPICreateTable)(const struct DBAPIConn *, DBAPIQueryCallback, DBAPIUserData, const char *, ...) __attribute__ ((format (printf, 4, 5)));
  36 typedef void (*DBAPICreateTableV)(const struct DBAPIConn *, DBAPIQueryCallback, DBAPIUserData, const char *);
  37 typedef void (*DBAPILoadTable)(const struct DBAPIConn *, DBAPIQueryCallback, DBAPIQueryCallback, DBAPIQueryCallback, DBAPIUserData, const char *);
  38
  39 typedef void (*DBAPISafeQuery)(const struct DBAPIConn *, DBAPIQueryCallback, DBAPIUserData, const char *, const char *, ...);
  40 typedef void (*DBAPISafeSimpleQuery)(const struct DBAPIConn *, const char *, const char *, ...);
  41 typedef void (*DBAPISafeCreateTable)(const struct DBAPIConn *, DBAPIQueryCallback, DBAPIUserData, const char *, const char *, ...);
  42
  43 typedef void (*DBAPIEscapeString)(const struct DBAPIConn *, char *, const char *, size_t);
  44 typedef int (*DBAPIQuoteString)(const struct DBAPIConn *, char *, size_t, const char *, size_t);
  45
  46 typedef char *(*DBAPITableName)(const struct DBAPIConn *, const char *);
  47
  48 struct DBAPIProviderData;
  49
  50 typedef struct DBAPIProvider {
  51   DBAPINew new;
  52   DBAPIClose close;
  53
  54   DBAPIQueryV query;
  55   DBAPICreateTableV createtable;
  56   DBAPILoadTable loadtable;
  57
  58   DBAPITableName tablename;
  59
  60   DBAPIEscapeString escapestring;
  61   DBAPIQuoteString quotestring;
  62
  63 /* private members */
  64   struct DBAPIProviderData *__providerdata;
  65 } DBAPIProvider;
  66
  67 typedef struct DBAPIConn {
  68   DBAPIClose close;
  69
  70   DBAPIQuery unsafequery;
  71   DBAPISimpleQuery unsafesquery;
  72   DBAPICreateTable unsafecreatetable;
  73   DBAPILoadTable loadtable;
  74   DBAPIEscapeString escapestring; /* deprecated */
  75   DBAPITableName tablename;
  76
  77   DBAPISafeQuery query;
  78   DBAPISafeSimpleQuery squery;
  79   DBAPISafeCreateTable createtable;
  80
  81   char name[DBNAME_LEN+1];
  82
  83   void *handle;
  84
  85 /* private members */
  86   DBAPIClose __close;
  87   DBAPIQuoteString __quotestring;
  88   DBAPIQueryV __query;
  89   DBAPICreateTableV __createtable;
  90   DBAPILoadTable __loadtable;
  91 } DBAPIConn;
  92
  93 typedef char *(*DBAPIResultGet)(const struct DBAPIResult *, unsigned int);
  94 typedef int (*DBAPIResultNext)(const struct DBAPIResult *);
  95 typedef void (*DBAPIResultClear)(const struct DBAPIResult *);
  96
  97 typedef struct DBAPIResult {
  98   DBAPI2_RESULT_HANDLE *handle;
  99
 100   unsigned short success, fields;
 101
 102   DBAPIResultGet get;
 103   DBAPIResultNext next;
 104   DBAPIResultClear clear;
 105 } DBAPIResult;
 106
 107 int registerdbprovider(const char *, DBAPIProvider *);
 108 void deregisterdbprovider(int);
 109 DBAPIConn *dbapi2open(const char *, const char *);
 110
 111 #endif