mysql.h
上传用户:tsgydb
上传日期:2007-04-14
资源大小:10674k
文件大小:10k
源码类别:

MySQL数据库

开发平台:

Visual C++

  1. /* Copyright (C) 2000 MySQL AB & MySQL Finland AB & TCX DataKonsult AB
  2.    
  3.    This library is free software; you can redistribute it and/or
  4.    modify it under the terms of the GNU Library General Public
  5.    License as published by the Free Software Foundation; either
  6.    version 2 of the License, or (at your option) any later version.
  7.    
  8.    This library is distributed in the hope that it will be useful,
  9.    but WITHOUT ANY WARRANTY; without even the implied warranty of
  10.    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  11.    Library General Public License for more details.
  12.    
  13.    You should have received a copy of the GNU Library General Public
  14.    License along with this library; if not, write to the Free
  15.    Software Foundation, Inc., 59 Temple Place - Suite 330, Boston,
  16.    MA 02111-1307, USA */
  17. /* defines for the libmysql library */
  18. #ifndef _mysql_h
  19. #define _mysql_h
  20. #ifndef MYSQL_SERVER
  21. #ifdef __cplusplus
  22. extern "C" {
  23. #endif
  24. #endif
  25.   
  26. #ifndef _global_h /* If not standard header */
  27. #include <sys/types.h>
  28. typedef char my_bool;
  29. #if (defined(_WIN32) || defined(_WIN64)) && !defined(__WIN__)
  30. #define __WIN__
  31. #endif
  32. #if !defined(__WIN__)
  33. #define STDCALL
  34. #else
  35. #define STDCALL __stdcall
  36. #endif
  37. typedef char * gptr;
  38. #ifndef ST_USED_MEM_DEFINED
  39. #define ST_USED_MEM_DEFINED
  40. typedef struct st_used_mem { /* struct for once_alloc */
  41.   struct st_used_mem *next; /* Next block in use */
  42.   unsigned int left; /* memory left in block  */
  43.   unsigned int size; /* size of block */
  44. } USED_MEM;
  45. typedef struct st_mem_root {
  46.   USED_MEM *free;
  47.   USED_MEM *used;
  48.   USED_MEM *pre_alloc;
  49.   unsigned int min_malloc;
  50.   unsigned int block_size;
  51.   void (*error_handler)(void);
  52. } MEM_ROOT;
  53. #endif
  54. #ifndef my_socket_defined
  55. #ifdef __WIN__
  56. #define my_socket SOCKET
  57. #else
  58. typedef int my_socket;
  59. #endif
  60. #endif
  61. #endif
  62. #include "mysql_com.h"
  63. #include "mysql_version.h"
  64. extern unsigned int mysql_port;
  65. extern char *mysql_unix_port;
  66. #define IS_PRI_KEY(n) ((n) & PRI_KEY_FLAG)
  67. #define IS_NOT_NULL(n) ((n) & NOT_NULL_FLAG)
  68. #define IS_BLOB(n) ((n) & BLOB_FLAG)
  69. #define IS_NUM(t) ((t) <= FIELD_TYPE_INT24 || (t) == FIELD_TYPE_YEAR)
  70. #define IS_NUM_FIELD(f)  ((f)->flags & NUM_FLAG)
  71. #define INTERNAL_NUM_FIELD(f) (((f)->type <= FIELD_TYPE_INT24 && ((f)->type != FIELD_TYPE_TIMESTAMP || (f)->length == 14 || (f)->length == 8)) || (f)->type == FIELD_TYPE_YEAR)
  72. typedef struct st_mysql_field {
  73.   char *name; /* Name of column */
  74.   char *table; /* Table of column if column was a field */
  75.   char *def; /* Default value (set by mysql_list_fields) */
  76.   enum enum_field_types type; /* Type of field. Se mysql_com.h for types */
  77.   unsigned int length; /* Width of column */
  78.   unsigned int max_length; /* Max width of selected set */
  79.   unsigned int flags; /* Div flags */
  80.   unsigned int decimals; /* Number of decimals in field */
  81. } MYSQL_FIELD;
  82. typedef char **MYSQL_ROW; /* return data as array of strings */
  83. typedef unsigned int MYSQL_FIELD_OFFSET; /* offset to current field */
  84. #if defined(NO_CLIENT_LONG_LONG)
  85. typedef unsigned long my_ulonglong;
  86. #elif defined (__WIN__)
  87. typedef unsigned __int64 my_ulonglong;
  88. #else
  89. typedef unsigned long long my_ulonglong;
  90. #endif
  91. #define MYSQL_COUNT_ERROR (~(my_ulonglong) 0)
  92. typedef struct st_mysql_rows {
  93.   struct st_mysql_rows *next; /* list of rows */
  94.   MYSQL_ROW data;
  95. } MYSQL_ROWS;
  96. typedef MYSQL_ROWS *MYSQL_ROW_OFFSET; /* offset to current row */
  97. typedef struct st_mysql_data {
  98.   my_ulonglong rows;
  99.   unsigned int fields;
  100.   MYSQL_ROWS *data;
  101.   MEM_ROOT alloc;
  102. } MYSQL_DATA;
  103. struct st_mysql_options {
  104.   unsigned int connect_timeout,client_flag;
  105.   my_bool compress,named_pipe;
  106.   unsigned int port;
  107.   char *host,*init_command,*user,*password,*unix_socket,*db;
  108.   char *my_cnf_file,*my_cnf_group, *charset_dir, *charset_name;
  109.   my_bool use_ssl; /* if to use SSL or not */
  110.   char *ssl_key; /* PEM key file */
  111.   char *ssl_cert; /* PEM cert file */
  112.   char *ssl_ca; /* PEM CA file */
  113.   char *ssl_capath; /* PEM directory of CA-s? */
  114. };
  115. enum mysql_option { MYSQL_OPT_CONNECT_TIMEOUT, MYSQL_OPT_COMPRESS,
  116.     MYSQL_OPT_NAMED_PIPE, MYSQL_INIT_COMMAND,
  117.     MYSQL_READ_DEFAULT_FILE, MYSQL_READ_DEFAULT_GROUP,
  118.     MYSQL_SET_CHARSET_DIR, MYSQL_SET_CHARSET_NAME};
  119. enum mysql_status { MYSQL_STATUS_READY,MYSQL_STATUS_GET_RESULT,
  120.     MYSQL_STATUS_USE_RESULT};
  121. typedef struct st_mysql {
  122.   NET net; /* Communication parameters */
  123.   gptr connector_fd; /* ConnectorFd for SSL */
  124.   char *host,*user,*passwd,*unix_socket,*server_version,*host_info,
  125. *info,*db;
  126.   unsigned int port,client_flag,server_capabilities;
  127.   unsigned int protocol_version;
  128.   unsigned int field_count;
  129.   unsigned int  server_status;
  130.   unsigned long thread_id; /* Id for connection in server */
  131.   my_ulonglong affected_rows;
  132.   my_ulonglong insert_id; /* id if insert on table with NEXTNR */
  133.   my_ulonglong extra_info; /* Used by mysqlshow */
  134.   unsigned long packet_length;
  135.   enum mysql_status status;
  136.   MYSQL_FIELD *fields;
  137.   MEM_ROOT field_alloc;
  138.   my_bool free_me; /* If free in mysql_close */
  139.   my_bool reconnect; /* set to 1 if automatic reconnect */
  140.   struct st_mysql_options options;
  141.   char         scramble_buff[9];
  142.   struct charset_info_st *charset;
  143.   unsigned int  server_language;
  144. } MYSQL;
  145. typedef struct st_mysql_res {
  146.   my_ulonglong row_count;
  147.   unsigned int field_count, current_field;
  148.   MYSQL_FIELD *fields;
  149.   MYSQL_DATA *data;
  150.   MYSQL_ROWS *data_cursor;
  151.   MEM_ROOT field_alloc;
  152.   MYSQL_ROW row; /* If unbuffered read */
  153.   MYSQL_ROW current_row; /* buffer to current row */
  154.   unsigned long *lengths; /* column lengths of current row */
  155.   MYSQL *handle; /* for unbuffered reads */
  156.   my_bool eof; /* Used my mysql_fetch_row */
  157. } MYSQL_RES;
  158. /* Functions to get information from the MYSQL and MYSQL_RES structures */
  159. /* Should definitely be used if one uses shared libraries */
  160. my_ulonglong STDCALL mysql_num_rows(MYSQL_RES *res);
  161. unsigned int STDCALL mysql_num_fields(MYSQL_RES *res);
  162. my_bool STDCALL mysql_eof(MYSQL_RES *res);
  163. MYSQL_FIELD *STDCALL mysql_fetch_field_direct(MYSQL_RES *res,
  164.       unsigned int fieldnr);
  165. MYSQL_FIELD * STDCALL mysql_fetch_fields(MYSQL_RES *res);
  166. MYSQL_ROWS * STDCALL mysql_row_tell(MYSQL_RES *res);
  167. unsigned int STDCALL mysql_field_tell(MYSQL_RES *res);
  168. unsigned int STDCALL mysql_field_count(MYSQL *mysql);
  169. my_ulonglong STDCALL mysql_affected_rows(MYSQL *mysql);
  170. my_ulonglong STDCALL mysql_insert_id(MYSQL *mysql);
  171. unsigned int STDCALL mysql_errno(MYSQL *mysql);
  172. char * STDCALL mysql_error(MYSQL *mysql);
  173. char * STDCALL mysql_info(MYSQL *mysql);
  174. unsigned long STDCALL mysql_thread_id(MYSQL *mysql);
  175. const char * STDCALL mysql_character_set_name(MYSQL *mysql);
  176. MYSQL * STDCALL mysql_init(MYSQL *mysql);
  177. #ifdef HAVE_OPENSSL
  178. int STDCALL mysql_ssl_set(MYSQL *mysql, const char *key,
  179.       const char *cert, const char *ca,
  180.       const char *capath);
  181. char * STDCALL mysql_ssl_cipher(MYSQL *mysql);
  182. int STDCALL mysql_ssl_clear(MYSQL *mysql);
  183. #endif /* HAVE_OPENSSL */
  184. MYSQL * STDCALL mysql_connect(MYSQL *mysql, const char *host,
  185.       const char *user, const char *passwd);
  186. my_bool STDCALL mysql_change_user(MYSQL *mysql, const char *user, 
  187.   const char *passwd, const char *db);
  188. #if MYSQL_VERSION_ID >= 32200
  189. MYSQL * STDCALL mysql_real_connect(MYSQL *mysql, const char *host,
  190.    const char *user,
  191.    const char *passwd,
  192.    const char *db,
  193.    unsigned int port,
  194.    const char *unix_socket,
  195.    unsigned int clientflag);
  196. #else
  197. MYSQL * STDCALL mysql_real_connect(MYSQL *mysql, const char *host,
  198.    const char *user,
  199.    const char *passwd,
  200.    unsigned int port,
  201.    const char *unix_socket,
  202.    unsigned int clientflag);
  203. #endif
  204. void STDCALL mysql_close(MYSQL *sock);
  205. int STDCALL mysql_select_db(MYSQL *mysql, const char *db);
  206. int STDCALL mysql_query(MYSQL *mysql, const char *q);
  207. int STDCALL mysql_send_query(MYSQL *mysql, const char *q,
  208.  unsigned int length);
  209. int STDCALL mysql_read_query_result(MYSQL *mysql);
  210. int STDCALL mysql_real_query(MYSQL *mysql, const char *q,
  211. unsigned int length);
  212. int STDCALL mysql_create_db(MYSQL *mysql, const char *DB);
  213. int STDCALL mysql_drop_db(MYSQL *mysql, const char *DB);
  214. int STDCALL mysql_shutdown(MYSQL *mysql);
  215. int STDCALL mysql_dump_debug_info(MYSQL *mysql);
  216. int STDCALL mysql_refresh(MYSQL *mysql,
  217.      unsigned int refresh_options);
  218. int STDCALL mysql_kill(MYSQL *mysql,unsigned long pid);
  219. int STDCALL mysql_ping(MYSQL *mysql);
  220. char * STDCALL mysql_stat(MYSQL *mysql);
  221. char * STDCALL mysql_get_server_info(MYSQL *mysql);
  222. char * STDCALL mysql_get_client_info(void);
  223. char * STDCALL mysql_get_host_info(MYSQL *mysql);
  224. unsigned int STDCALL mysql_get_proto_info(MYSQL *mysql);
  225. MYSQL_RES * STDCALL mysql_list_dbs(MYSQL *mysql,const char *wild);
  226. MYSQL_RES * STDCALL mysql_list_tables(MYSQL *mysql,const char *wild);
  227. MYSQL_RES * STDCALL mysql_list_fields(MYSQL *mysql, const char *table,
  228.  const char *wild);
  229. MYSQL_RES * STDCALL mysql_list_processes(MYSQL *mysql);
  230. MYSQL_RES * STDCALL mysql_store_result(MYSQL *mysql);
  231. MYSQL_RES * STDCALL mysql_use_result(MYSQL *mysql);
  232. int STDCALL mysql_options(MYSQL *mysql,enum mysql_option option,
  233.       const char *arg);
  234. void STDCALL mysql_free_result(MYSQL_RES *result);
  235. void STDCALL mysql_data_seek(MYSQL_RES *result,
  236. my_ulonglong offset);
  237. MYSQL_ROW_OFFSET STDCALL mysql_row_seek(MYSQL_RES *result, MYSQL_ROW_OFFSET);
  238. MYSQL_FIELD_OFFSET STDCALL mysql_field_seek(MYSQL_RES *result,
  239.    MYSQL_FIELD_OFFSET offset);
  240. MYSQL_ROW STDCALL mysql_fetch_row(MYSQL_RES *result);
  241. unsigned long * STDCALL mysql_fetch_lengths(MYSQL_RES *result);
  242. MYSQL_FIELD * STDCALL mysql_fetch_field(MYSQL_RES *result);
  243. unsigned long STDCALL mysql_escape_string(char *to,const char *from,
  244.     unsigned long from_length);
  245. unsigned long STDCALL mysql_real_escape_string(MYSQL *mysql,
  246.        char *to,const char *from,
  247.        unsigned long length);
  248. void STDCALL mysql_debug(const char *debug);
  249. char * STDCALL mysql_odbc_escape_string(MYSQL *mysql,
  250.  char *to,
  251.  unsigned long to_length,
  252.  const char *from,
  253.  unsigned long from_length,
  254.  void *param,
  255.  char *
  256.  (*extend_buffer)
  257.  (void *, char *to,
  258.   unsigned long *length));
  259. void  STDCALL myodbc_remove_escape(MYSQL *mysql,char *name);
  260. unsigned int STDCALL mysql_thread_safe(void);
  261.   
  262. #define mysql_reload(mysql) mysql_refresh((mysql),REFRESH_GRANT)
  263. /* new api functions */
  264. #define HAVE_MYSQL_REAL_CONNECT
  265. #ifndef MYSQL_SERVER  
  266. #ifdef __cplusplus
  267. }
  268. #endif
  269. #endif
  270. #endif