1、初始化一个MYSQL结构
MYSQL *mysql_init(MYSQL *mysql)
2、关闭一个服务器连接，并释放与连接相关的内存
void mysql_close(MYSQL *mysql);
3、连接一个MySQL服务器
MYSQL *mysql_real_connect(MYSQL *mysql,const char *host,const char *user,const char *passwd, const char *db,unsigned int port,const char *unix_socket,unsigned int client_flag);
参数说明：
host表示MYSQL服务器的主机名或IP
user表示登录的用户名
passwd表示登录的密码
db表示要连接的数据库
port表示MySQL服务器的TCP/IP端口
unix_socket表示连接类型
client_flag表示MySQL运行ODBC数据库的标记
函数返回值： 如果连接成功，一个MYSQL*连接句柄：如果连接失败，NULL
4、返回最新的UPDATE，DELETE或INSERT查询影响的行数
int mysql_query(MYSQL *mysql,const char *query);
query表示执行的SQL语句
函数返回值： 如果查询成功，为零，出错为非零。
补充：对于包含二进制数据的查询，必须使用mysql_real_query()而不是mysql_query()，这是因为，二进制数据可能会包含‘\0’字符。此外，mysql_real_query()比mysql_query()快，这是因为它不会在查询字符串上调用strlen()。
int mysql_real_query(MYSQL *mysql, const char *query, unsigned long length)；
5、为无缓冲的结果集获得结果标识符
MYSQL_RES *mysql_use_result(MYSQL *mysql);
函数返回值： 一个MYSQL_RES结果结构， 如果发生一个错误发NULL
返回值给其他的函数引用。
6、存储查询结果
MYSQL_RES *mysql_store_result(MYSQL *mysql);
函数返回值： 一个MYSQL_RES结果结构， 如果发生一个错误发NULL
返回值给其他的函数引用。
注意：其中一个方式是通过调用 mysql_store_result()来一次性获得整个查询结果。整个函数从服务器数据库中获得所有的行，并保存在客户端中。第二个方式是通过调用mysql_use_result()来初始化一行一行的读取检索结果。这个函数只进行初始化，实际上并不会从服务器中获取任何的一行。
7、检索一个结果集合的下一行，行内值的数目由mysql_num_fields(result)给出。如果行中保存了调用mysql_fetch_row()返回的值，将按照row[0]到row[mysql_num_fields(result)-1]，访问这些值的指针
MYSQL_ROW mysql_fetch_row(MYSQL_RES *result);
下一行的一个MYSQL_ROW结构。
如果没有更多的行可检索或如果出现一个错误，NULL
在上面两个情况下，你可以通过调用 mysql_fetch_row()来获取每一行。使用mysql_store_result()时，mysql_fetch_row()函数获取每一行，其中数据之前就已经从服务器数据库中获得；使用mysql_use_result()时，mysql_fetch_row()函数实际上是从服务器数据库中实时获取每一行。可以调用mysql_fetch_lengths()来获取每一行数据的大小信息。
当你操作完result集合后，调用 mysql_free_result()来释放之前使用的内存。
8、返回指定结果集中列的数量(row(行），fields(列））
unsigned int mysql_num_fields(MYSQL_RES *res);
mysql_store_result()的其中一个优点是，因为所有的行已经从数据库中获取，因此你不仅可以顺序的获取每一行，还可以使用 mysql_data_seek()或者mysql_row_seek()来改变当前在result集合中读取的位置（行号）。你也可以通过调用 mysql_num_rows()来获知有多少行。另一方面，mysql_store_result()对内存的要求可能会很高（对于很大的result集合来说），因此，你会更大概率上遇到内存不够用的情况。
mysql_use_result()的一个优点是客户端只需要很少的内存空间来存放result集合，因为每次只需要存一行的数据（因为申请的内存空间少了，mysql_use_result()运行速度也更快了）。缺点是你必须快速处理每一行来避免过多占用服务器数据库，而且你也不能在result集合中随机访问每一行，你只能顺序的访问每一行。全部的总行数你是不知道的，直到全部检索完毕。还有，你必须全部检索完所有行，即使当你在中间部分已经找到了想要的结果。
API函数在不需要知道是否是一个SELECT语句的情况下，提供了客户端对操作语句的一个合适的响应。你可以在调用每个mysql_query() (或者 mysql_real_query())函数之后，再调用 mysql_store_result()。如果result集合调用成功，这个操作语句是一个SELECT语句，然后就可以读取每一行。如果返回结果为失败，那么调用 mysql_field_count() 来查看失败结果是否是实际所期待的（你想得到的结果就是失败）。如果mysql_field_count()返回0，操作语句不返回任何数据（说明操作语句是一个INSERT，UPDATE或者DELETE语句等等），因此也不会返回行数据。如果mysql_field_count()返回非零值，那么操作语句本应该返回数据，实际却没有返回。这个表明是一个SELECT操作语句，但是操作失败了。可以去mysql_field_count()查看如何处理这种情况。
mysql_store_result() 和 mysql_use_result() 都可以让你获取有关result集合的字段信息（字段的序号，名称和类型等）。你可以通过重复调用 mysql_fetch_field()来顺序的获取信息，或者调用 mysql_fetch_field_direct()（该函数需要给定序号）来获取某一序号的信息（不需要按顺序获取）。可以通过调用mysql_field_seek()来改变当前字段光标位置。也可以通过调用***mysql_fetch_fields()一次性获取全部字段***。表的“列”称为“字段
对于检测和报告错误，MySQL提供了获取用户信息的渠道，即使用 mysql_errno() 和 mysql_error() 两个函数。这两个函数为最新调用的函数提供了返回错误代号或者错误信息，可以让你知道错误什么时候发生和错误是什么。
9、创建一个数据库
int mysql_create_db(MYSQL *mysql,const char *db);
db:要创建的数据库名
如果数据库成功地被创建，返回零，如果发生错误，为非零。
10、选择一个数据库
int mysql_select_db(MYSQL *mysql,const char *db);
db:要创建的数据库名
如果数据库成功地被创建，返回零，如果发生错误，为非零。
示例：对数据库的基本操作（增删改查）
#include <stdio.h>
#include <mysql.h>
#include <string.h>
int main(int argc, const char *argv[])
{
MYSQL mysql;
MYSQL_RES *res = NULL;
MYSQL_ROW row;
char *query_str = NULL;
int rc, i, fields;
int rows;
if (NULL == mysql_init(&mysql))
{
printf("mysql_init(): %s\n", mysql_error(&mysql));
return -1;
}
if (NULL == mysql_real_connect(&mysql, "localhost", "root", "shallnet", "db_users", 0, NULL,0))
{
printf("mysql_real_connect(): %s\n", mysql_error(&mysql));
return -1;
}
printf("1. Connected MySQL successful! \n");
//执行插入请求
query_str = "insert into tb_users values (12345, 'justtest', '2015-5-5')";
rc = mysql_real_query(&mysql, query_str, strlen(query_str));
if (0 != rc)
{
printf("mysql_real_query(): %s\n", mysql_error(&mysql));
return -1;
}
//执行删除请求
query_str = "delete from tb_users where userid=10006";
rc = mysql_real_query(&mysql, query_str, strlen(query_str));
if (0 != rc)
{
printf("mysql_real_query(): %s\n", mysql_error(&mysql));
return -1;
}
//然后查询插入删除之后的数据
query_str = "select * from tb_users";
rc = mysql_real_query(&mysql, query_str, strlen(query_str));
if (0 != rc)
{
printf("mysql_real_query(): %s\n", mysql_error(&mysql));
return -1;
}
res = mysql_store_result(&mysql);
if (NULL == res)
{
printf("mysql_restore_result(): %s\n", mysql_error(&mysql));
return -1;
}
rows = mysql_num_rows(res);
printf("The total rows is: %d\n", rows);
fields = mysql_num_fields(res);
printf("The total fields is: %d\n", fields);
while ((row = mysql_fetch_row(res)))
{
for (i = 0; i < fields; i++)
{
printf("%s\t", row[i]);
}
printf("\n");
}
mysql_free_result(res);
mysql_close(&mysql);
return 0;
}