141 lines
3.7 KiB
C++
141 lines
3.7 KiB
C++
#ifndef _INCLUDE_SOURCEMOD_DATABASE2_H
|
|
#define _INCLUDE_SOURCEMOD_DATABASE2_H
|
|
|
|
#include <stdarg.h>
|
|
|
|
namespace SourceMod
|
|
{
|
|
class IResultRow
|
|
{
|
|
public:
|
|
/**
|
|
* This will return NULL if the entry is NULL.
|
|
* Remember that in SQL, a field can have NULL
|
|
* entries, which are not the same as 0 or "".
|
|
*/
|
|
virtual const char *GetString(unsigned int columnId) =0;
|
|
virtual double GetDouble(unsigned int columnId) =0;
|
|
virtual float GetFloat(unsigned int columnId) =0;
|
|
virtual int GetInt(unsigned int columnId) =0;
|
|
virtual bool IsNull(unsigned int columnId) =0;
|
|
/**
|
|
* NULL can be returned. The length will be zero if so.
|
|
*/
|
|
virtual const char *GetRaw(unsigned int columnId, size_t *length) =0;
|
|
};
|
|
|
|
class IResultSet
|
|
{
|
|
public:
|
|
//free the handle if necessary (see IQuery).
|
|
virtual void FreeHandle() =0;
|
|
public: //Basic stuff
|
|
virtual unsigned int RowCount() =0;
|
|
virtual unsigned int FieldCount() =0;
|
|
virtual const char *FieldNumToName(unsigned int num) =0;
|
|
virtual bool FieldNameToNum(const char *name, unsigned int *columnId) =0;
|
|
public: //iteration
|
|
/**
|
|
* Returns true if there are no more handles left.
|
|
*/
|
|
virtual bool IsDone() =0;
|
|
/**
|
|
* Returns the current row. If "IsDone()" is false
|
|
* this is guaranteed to return non-NULL.
|
|
* Handles to IResultRow are guaranteed to not leak
|
|
* (you don't need to free them), however,
|
|
* they should be considered volatile - don't cache
|
|
* them.
|
|
*/
|
|
virtual IResultRow *GetRow() =0;
|
|
/**
|
|
* Advances to the next row. Note that you need to
|
|
* call IsDone() after each call to NextRow().
|
|
*/
|
|
virtual void NextRow() =0;
|
|
};
|
|
|
|
struct QueryInfo
|
|
{
|
|
IResultSet *rs;
|
|
unsigned long long affected_rows;
|
|
int errorcode;
|
|
bool success;
|
|
};
|
|
|
|
class IQuery
|
|
{
|
|
public:
|
|
//you must free the handle when done
|
|
virtual void FreeHandle() =0;
|
|
public:
|
|
/**
|
|
* Executes the query. Specify optional error string buffer.
|
|
* If "info" is NULL, no results will be stored.
|
|
* Returns false on failure.
|
|
* Calling Execute() multiple times will cause each result handle
|
|
* to be freed in succession. That means that you do not need to
|
|
* explicitly free IResultSets when using Execute(), but their
|
|
* handles are deep-invalidated on succesive calls, and
|
|
* thus Execute() is also not thread safe.
|
|
*/
|
|
virtual bool Execute(QueryInfo *info, char *error, size_t maxlength) =0;
|
|
/**
|
|
* Same as above, except result handles are not freed for you.
|
|
*/
|
|
virtual bool ExecuteR(QueryInfo *info, char *error, size_t maxlength) =0;
|
|
/**
|
|
* Returns the query string.
|
|
*/
|
|
virtual const char *GetQueryString() =0;
|
|
};
|
|
|
|
class ISQLDriver;
|
|
|
|
class IDatabase
|
|
{
|
|
public:
|
|
/**
|
|
* Closes the database and frees the handle.
|
|
*/
|
|
virtual void FreeHandle() =0;
|
|
/**
|
|
* Returns the parent driver.
|
|
*/
|
|
virtual ISQLDriver *Driver() =0;
|
|
public:
|
|
/**
|
|
* Query preparation.
|
|
*/
|
|
virtual IQuery *PrepareQueryFmt(const char *fmt, ...) =0;
|
|
virtual IQuery *PrepareQueryFmt(const char *fmt, va_list ap) =0;
|
|
virtual IQuery *PrepareQuery(const char *query) =0;
|
|
/**
|
|
* Quotes a string properly.
|
|
* Returns 0 on success. On failure, returns
|
|
* the size of the buffer needed, or a negative number
|
|
* on internal failure.
|
|
*/
|
|
virtual int QuoteString(const char *str, char buffer[], size_t maxlen, size_t *newsize) =0;
|
|
};
|
|
|
|
struct DatabaseInfo
|
|
{
|
|
const char *host;
|
|
const char *database;
|
|
const char *user;
|
|
const char *pass;
|
|
unsigned int port;
|
|
};
|
|
|
|
class ISQLDriver
|
|
{
|
|
public:
|
|
virtual IDatabase *Connect(DatabaseInfo *info, int *errcode, char *error, size_t maxlength) =0;
|
|
virtual const char *NameString() =0;
|
|
virtual bool IsCompatDriver(const char *namestring) =0;
|
|
};
|
|
};
|
|
|
|
#endif //_INCLUDE_SOURCEMOD_DATABASE2_H
|