2007-12-30 17:41:49 +01:00
|
|
|
/***************************************************************************
|
|
|
|
|
2014-09-22 04:52:05 +02:00
|
|
|
gb.db.h
|
2007-12-30 17:41:49 +01:00
|
|
|
|
2017-01-13 04:29:42 +01:00
|
|
|
(c) 2000-2017 Benoît Minisini <gambas@users.sourceforge.net>
|
2007-12-30 17:41:49 +01:00
|
|
|
|
2014-09-22 04:52:05 +02:00
|
|
|
This program is free software; you can redistribute it and/or modify
|
|
|
|
it under the terms of the GNU General Public License as published by
|
|
|
|
the Free Software Foundation; either version 2, or (at your option)
|
|
|
|
any later version.
|
2007-12-30 17:41:49 +01:00
|
|
|
|
2014-09-22 04:52:05 +02:00
|
|
|
This program is distributed in the hope that it will be useful,
|
|
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
|
GNU General Public License for more details.
|
2007-12-30 17:41:49 +01:00
|
|
|
|
2014-09-22 04:52:05 +02:00
|
|
|
You should have received a copy of the GNU General Public License
|
|
|
|
along with this program; if not, write to the Free Software
|
|
|
|
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
|
|
|
|
MA 02110-1301, USA.
|
2007-12-30 17:41:49 +01:00
|
|
|
|
|
|
|
***************************************************************************/
|
|
|
|
|
|
|
|
#ifndef __GB_DB_H
|
|
|
|
#define __GB_DB_H
|
|
|
|
|
|
|
|
#include "gambas.h"
|
|
|
|
|
|
|
|
#define DB_INTERFACE_VERSION 1
|
|
|
|
|
|
|
|
typedef
|
2014-09-22 04:52:05 +02:00
|
|
|
struct {
|
|
|
|
char *type;
|
|
|
|
char *host;
|
|
|
|
char *port;
|
|
|
|
char *name;
|
|
|
|
char *user;
|
|
|
|
char *password;
|
|
|
|
int options;
|
|
|
|
}
|
|
|
|
DB_DESC;
|
2007-12-30 17:41:49 +01:00
|
|
|
|
|
|
|
/* LIMIT position */
|
|
|
|
|
|
|
|
#define DB_LIMIT_NONE 0
|
|
|
|
#define DB_LIMIT_AT_BEGIN 1
|
|
|
|
#define DB_LIMIT_AT_END 2
|
|
|
|
|
|
|
|
typedef
|
|
|
|
struct {
|
2011-12-22 01:31:57 +01:00
|
|
|
void *handle; /* Connection handle */
|
|
|
|
int version; /* Version of the database system */
|
|
|
|
char *charset; /* Charset used by the database */
|
|
|
|
void *data; /* Can be used by the driver for storing its own private data */
|
2007-12-30 17:41:49 +01:00
|
|
|
int error; /* Last SQL error code raise by a query */
|
2011-12-22 01:31:57 +01:00
|
|
|
int timeout; /* Connection timeout */
|
2017-07-24 20:53:33 +02:00
|
|
|
int timezone; /* Timezone of dates (default to local timezone) */
|
2011-12-22 01:31:57 +01:00
|
|
|
unsigned ignore_case : 1; /* If table, field and index names are case sensitive */
|
2007-12-30 17:41:49 +01:00
|
|
|
struct {
|
2011-12-22 01:31:57 +01:00
|
|
|
unsigned no_table_type : 1; /* Tables do not have types */
|
|
|
|
unsigned no_serial : 1; /* Serial fields are not supported */
|
|
|
|
unsigned no_blob : 1; /* Blob fields are not supported */
|
|
|
|
unsigned no_seek : 1; /* Cannot seek anywhere in a Result */
|
|
|
|
unsigned no_nest : 1; /* Cannot nest transactions */
|
2014-10-18 15:23:29 +02:00
|
|
|
unsigned no_case : 1; /* table, field and index names must be converted to lower case */
|
2009-11-28 02:22:00 +01:00
|
|
|
unsigned schema : 1; /* If table names can be prefixed by a schema name and a dot */
|
2014-10-07 02:01:13 +02:00
|
|
|
unsigned no_collation : 1; /* No collation support at field level */
|
2014-11-16 22:40:47 +01:00
|
|
|
unsigned system : 1; /* system database */
|
2007-12-30 17:41:49 +01:00
|
|
|
}
|
|
|
|
flags;
|
|
|
|
struct {
|
2011-12-22 01:31:57 +01:00
|
|
|
const char *keyword; /* keyword for limiting the result of a query */
|
|
|
|
int pos; /* position of 'limit' keyword */
|
2007-12-30 17:41:49 +01:00
|
|
|
}
|
|
|
|
limit;
|
2008-02-02 11:54:13 +01:00
|
|
|
const char *db_name_char; /* These characters are allowed in a database name */
|
2007-12-30 17:41:49 +01:00
|
|
|
}
|
2014-09-22 04:52:05 +02:00
|
|
|
DB_DATABASE;
|
2007-12-30 17:41:49 +01:00
|
|
|
|
|
|
|
typedef
|
2014-09-22 04:52:05 +02:00
|
|
|
void *DB_RESULT;
|
2007-12-30 17:41:49 +01:00
|
|
|
|
|
|
|
typedef
|
2014-09-22 04:52:05 +02:00
|
|
|
struct _DB_FIELD {
|
|
|
|
struct _DB_FIELD *next;
|
|
|
|
char *name;
|
|
|
|
GB_TYPE type; /* gambas field type */
|
|
|
|
int length; /* max length for text fields (0 = no limit) */
|
|
|
|
GB_VARIANT_VALUE def; /* default value */
|
|
|
|
char *collation; /* field collation */
|
|
|
|
}
|
|
|
|
DB_FIELD;
|
2007-12-30 17:41:49 +01:00
|
|
|
|
|
|
|
|
|
|
|
typedef
|
2014-09-22 04:52:05 +02:00
|
|
|
struct {
|
|
|
|
char *table;
|
|
|
|
int nfield;
|
|
|
|
int nindex;
|
|
|
|
DB_FIELD *field;
|
|
|
|
int *index;
|
|
|
|
}
|
|
|
|
DB_INFO;
|
2007-12-30 17:41:49 +01:00
|
|
|
|
|
|
|
typedef
|
2014-09-22 04:52:05 +02:00
|
|
|
struct {
|
|
|
|
char *name;
|
|
|
|
char *fields; /* list of index fields separated by commas */
|
|
|
|
int unique; /* index is unique */
|
|
|
|
int primary; /* primary index */
|
|
|
|
}
|
|
|
|
DB_INDEX;
|
2007-12-30 17:41:49 +01:00
|
|
|
|
|
|
|
typedef
|
2014-09-22 04:52:05 +02:00
|
|
|
struct {
|
|
|
|
char *name;
|
|
|
|
char *password;
|
|
|
|
int admin; /* user is a superuser */
|
|
|
|
}
|
|
|
|
DB_USER;
|
2007-12-30 17:41:49 +01:00
|
|
|
|
|
|
|
typedef
|
|
|
|
struct {
|
|
|
|
GB_BASE ob;
|
|
|
|
char *data;
|
|
|
|
int length;
|
|
|
|
int constant;
|
|
|
|
}
|
|
|
|
DB_BLOB;
|
|
|
|
|
|
|
|
typedef
|
2014-09-22 04:52:05 +02:00
|
|
|
void (*DB_FORMAT_CALLBACK)(const char *, int);
|
2007-12-30 17:41:49 +01:00
|
|
|
|
|
|
|
typedef
|
2014-09-22 04:52:05 +02:00
|
|
|
void (*DB_SUBST_CALLBACK)(int, char **, int *, char);
|
2007-12-30 17:41:49 +01:00
|
|
|
|
|
|
|
typedef
|
2014-09-22 04:52:05 +02:00
|
|
|
struct {
|
|
|
|
const char *name;
|
|
|
|
|
|
|
|
int (*Open)(DB_DESC *desc, DB_DATABASE *db);
|
|
|
|
void (*Close)(DB_DATABASE *db);
|
|
|
|
|
|
|
|
int (*Format)(GB_VALUE *val, DB_FORMAT_CALLBACK add);
|
|
|
|
void (*FormatBlob)(DB_BLOB *blob, DB_FORMAT_CALLBACK add);
|
|
|
|
|
|
|
|
int (*Exec)(DB_DATABASE *db, const char *, DB_RESULT *result, const char *err);
|
|
|
|
|
|
|
|
int (*Begin)(DB_DATABASE *db);
|
|
|
|
int (*Commit)(DB_DATABASE *db);
|
|
|
|
int (*Rollback)(DB_DATABASE *db);
|
|
|
|
GB_ARRAY (*GetCollations)(DB_DATABASE *db);
|
|
|
|
const char *(*GetQuote)(void);
|
|
|
|
|
|
|
|
struct {
|
|
|
|
void (*Init)(DB_RESULT result, DB_INFO *info, int *count);
|
|
|
|
int (*Fill)(DB_DATABASE *db, DB_RESULT result, int pos, GB_VARIANT_VALUE *buffer, int next);
|
|
|
|
void (*Blob)(DB_RESULT result, int pos, int field, DB_BLOB *blob);
|
|
|
|
void (*Release)(DB_RESULT result, DB_INFO *info);
|
|
|
|
struct {
|
|
|
|
GB_TYPE (*Type)(DB_RESULT result, int index);
|
|
|
|
char *(*Name)(DB_RESULT result, int index);
|
|
|
|
int (*Index)(DB_RESULT result, const char *name, DB_DATABASE *db);
|
|
|
|
int (*Length)(DB_RESULT result, int index);
|
|
|
|
}
|
|
|
|
Field;
|
|
|
|
}
|
|
|
|
Result;
|
|
|
|
|
|
|
|
struct {
|
|
|
|
int (*Exist)(DB_DATABASE *db, const char *table, const char *field);
|
|
|
|
int (*List)(DB_DATABASE *db, const char *table, char ***fields);
|
|
|
|
int (*Info)(DB_DATABASE *db, const char *table, const char *field, DB_FIELD *info);
|
|
|
|
}
|
|
|
|
Field;
|
|
|
|
|
|
|
|
struct {
|
|
|
|
int (*Init)(DB_DATABASE *db, const char *table, DB_INFO *info);
|
|
|
|
int (*Index)(DB_DATABASE *db, const char *table, DB_INFO *info);
|
|
|
|
void (*Release)(DB_DATABASE *db, DB_INFO *info);
|
|
|
|
int (*Exist)(DB_DATABASE *db, const char *table);
|
|
|
|
int (*List)(DB_DATABASE *db, char ***tables);
|
|
|
|
int (*PrimaryKey)(DB_DATABASE *db, const char *table, char ***primary);
|
|
|
|
int (*IsSystem)(DB_DATABASE *db, const char *table);
|
|
|
|
char *(*Type)(DB_DATABASE *db, const char *table, const char *type);
|
|
|
|
int (*Delete)(DB_DATABASE *db, const char *table);
|
|
|
|
int (*Create)(DB_DATABASE *db, const char *table, DB_FIELD *fields, char **primary, const char *tabletype);
|
|
|
|
}
|
|
|
|
Table;
|
|
|
|
|
|
|
|
struct {
|
|
|
|
int (*Exist)(DB_DATABASE *db, const char *table, const char *index);
|
|
|
|
int (*List)(DB_DATABASE *db, const char *table, char ***indexes);
|
|
|
|
int (*Info)(DB_DATABASE *db, const char *table, const char *index, DB_INDEX *info);
|
|
|
|
int (*Delete)(DB_DATABASE *db, const char *table, const char *index);
|
|
|
|
int (*Create)(DB_DATABASE *db, const char *table, const char *index, DB_INDEX *info);
|
|
|
|
}
|
|
|
|
Index;
|
|
|
|
|
|
|
|
struct {
|
|
|
|
int (*Exist)(DB_DATABASE *db, const char *name);
|
|
|
|
int (*List)(DB_DATABASE *db, char ***names);
|
|
|
|
int (*IsSystem)(DB_DATABASE *db, const char *name);
|
|
|
|
int (*Delete)(DB_DATABASE *db, const char *name);
|
|
|
|
int (*Create)(DB_DATABASE *db, const char *name);
|
|
|
|
}
|
|
|
|
Database;
|
|
|
|
|
|
|
|
struct {
|
|
|
|
int (*Exist)(DB_DATABASE *db, const char *user);
|
|
|
|
int (*List)(DB_DATABASE *db, char ***users);
|
|
|
|
int (*Info)(DB_DATABASE *db, const char *user, DB_USER *info);
|
|
|
|
int (*Delete)(DB_DATABASE *db, const char *user);
|
|
|
|
int (*Create)(DB_DATABASE *db, const char *user, DB_USER *info);
|
|
|
|
int (*SetPassword)(DB_DATABASE *db, const char *user, const char *password);
|
|
|
|
}
|
|
|
|
User;
|
|
|
|
}
|
|
|
|
DB_DRIVER;
|
2007-12-30 17:41:49 +01:00
|
|
|
|
|
|
|
typedef
|
2014-09-22 04:52:05 +02:00
|
|
|
struct {
|
|
|
|
intptr_t version;
|
|
|
|
void (*Register)(DB_DRIVER *);
|
|
|
|
void (*Format)(DB_DRIVER *, GB_VALUE *, DB_FORMAT_CALLBACK);
|
|
|
|
void (*FormatVariant)(DB_DRIVER *, GB_VARIANT_VALUE *, DB_FORMAT_CALLBACK);
|
|
|
|
int (*IsDebug)(void);
|
|
|
|
void (*TryAnother)(const char *);
|
|
|
|
char *(*SubstString)(const char *, int, DB_SUBST_CALLBACK);
|
|
|
|
char *(*QuoteString)(const char *, int, char);
|
|
|
|
char *(*UnquoteString)(const char *, int, char);
|
|
|
|
DB_DATABASE *(*GetCurrentDatabase)();
|
|
|
|
|
|
|
|
struct {
|
|
|
|
void (*Init)(void);
|
|
|
|
void (*Add)(const char *);
|
2014-10-18 15:23:29 +02:00
|
|
|
void (*AddLower)(const char *);
|
2014-09-22 04:52:05 +02:00
|
|
|
void (*AddLength)(const char *, int);
|
|
|
|
char *(*Get)(void);
|
|
|
|
char *(*GetNew)(void);
|
|
|
|
int (*Length)(void);
|
|
|
|
}
|
|
|
|
Query;
|
|
|
|
|
|
|
|
struct {
|
|
|
|
int (*Find)(char **, const char *);
|
|
|
|
}
|
|
|
|
StringArray;
|
|
|
|
}
|
|
|
|
DB_INTERFACE;
|
2007-12-30 17:41:49 +01:00
|
|
|
|
|
|
|
/* Field datatypes */
|
|
|
|
|
|
|
|
#define DB_T_SERIAL ((GB_TYPE)-1)
|
|
|
|
#define DB_T_BLOB ((GB_TYPE)-2)
|
|
|
|
|
2015-09-16 21:49:34 +02:00
|
|
|
// Result.Fill() return values
|
|
|
|
|
|
|
|
#define DB_OK 0
|
|
|
|
#define DB_ERROR 1
|
|
|
|
#define DB_NO_DATA 2
|
|
|
|
|
2007-12-30 17:41:49 +01:00
|
|
|
/* Field Separator Character e.g. Table.field = Table.field */
|
|
|
|
|
|
|
|
#define FLD_SEP '.'
|
|
|
|
|
|
|
|
#endif /* __MAIN_H */
|