MySQL数据库：使用mysql（Ubuntu）

一、MySQL安装

（一）安装mysql服务端

sudo apt-get install mysql-server

（二）安装图形开发界面

sudo apt-get install mysql-workbench

（三）安装mysql开发包

sudo apt-get install libmysqlclient-dev

二、API

（一）MYSQL

该结构代表1个数据库连接的句柄。几乎所有的MySQL函数均使用它。

（二）MYSQL_RES

该结构代表返回行的查询结果(SELECT, SHOW, DESCRIBE,EXPLAIN)。

（三）MYSQL_ROW

这是1行数据的“类型安全”表示。它目前是按照计数字节字符串的数组实施的。(如果字段值可能包含二进制数据,不能将其当作由Null终结的字符串对待,这是因为这类值可能会包含Null字节)。行是通过调用mysql_fetch_row()获得的。

（四）MYSQL_FIELD

该结构包含关于字段的信息,如字段名、类型和大小。通过重复调用mysql_fetch_field(),可为每个字段获得MYSQL_FIELD结构。字段值不是该结构的组成部份,它们包含在MYSQL_ROW结构中。

（五）MYSQL_FIELD_OFFSET

这是MySQL字段列表偏移量的“类型安全”表示(由mysql_field_seek()使用)。偏移量是行内的字段编号,从0开始。

三、mysql常用API

（一）mysql_init()

• 语法：

MYSQL *mysql_init(MYSQL *mysql)

• 描述：
  分配或初始化与mysql_real_connect()相适应的MYSQL对象。如果mysql是NULL指针,该函数将分配、初始化、并返回新对象。否则,将初始化对象,并返回对象的地址。如果mysql_init()分配了新的对象,当调用mysql_close()来关闭连接时。将释放该对象。
• 返回值：
  初始化的MYSQL*句柄。如果无足够内存以分配新的对象,返回NULL。

（二）mysql_real_connect()

• 语法：

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 long client_flag
)

• 描述：
  mysql_real_connect()尝试与运行在主机上的MySQL数据库引擎建立连接。在你能够执行需要有效MySQL连接句柄结构的任何其他API函数之前，mysql_real_connect()必须成功完成。关闭连接。
  如果“port”不是0，其值将用作TCP/IP连接的端口号。
  如果unix_socket不是NULL，该字符串描述了应使用的套接字或命名管道。
  注意：“host”参数决定了连接的类型。client_flag的值通常为0。
• 返回值：
  如果连接成功,返回MYSQL*连接句柄。如果连接失败，返回NULL。对于成功的连接，返回值与第1个参数的值相同。

（三）mysql_real_query()

• 语法：

int mysql_real_query(
MYSQL *mysql, 
const char *query, 
unsigned long length
)

• 描述：
  执行由“query”指向的SQL查询，它应是字符串长度字节“long”。
  正常情况下，字符串必须包含1条SQL语句，而且不应为语句添加终结分号(‘;’)或“\g”。如果允许多语句执行，字符串可包含由分号隔开的多条语句。对于包含二进制数据的查询，必须使用mysql_real_query()而不是mysql_query()。
• 返回值：
  如果查询成功,返回0。如果出现错误,返回非0值。

（四）mysql_store_result()

• 语法：

MYSQL_RES *mysql_store_result(MYSQL *mysql)

• 描述：
  对于成功检索了数据的每个查询(SELECT、SHOW、DESCRIBE、EXPLAIN、CHECK TABLE等)，必须调用mysql_store_result()或mysql_use_result() 。mysql_store_result()将查询的全部结果读取到客户端，分配1个MYSQL_RES结构,并将结果置于该结构中。调用mysql_num_rows()可以找出结果集中的行数。可以调用mysql_fetch_row()来获取结果集中的行，或调用mysql_row_seek()和mysql_row_tell()来获取或设置结果集中的当前行位置。
• 返回值：
  具有多个结果的MYSQL_RES结果集合。如果出现错误,返回NULL。

（五）mysql_use_result()

• 语法：

MYSQL_RES *mysql_use_result(MYSQL *mysql)

• 描述：
  mysql_use_result()将初始化结果集检索，但并不像mysql_store_result()那样将结果集实际读取到客户端。它必须通过对mysql_fetch_row()的调用，对每一行分别进行检索。这将直接从服务器读取结果,而不会将其保存在临时表或本地缓冲区内，与mysql_store_result()相比，速度更快而且使用的内存也更少。使用mysql_use_result()时，必须执行mysql_fetch_row()，直至返回NULL值。
• 返回值：
  具有多个结果的MYSQL_RES结果集合。如果出现错误,返回NULL。

（六）mysql_fetch_row()

• 语法：

MYSQL_ROW mysql_fetch_row(MYSQL_RES *result)

• 描述：
  检索结果集的下一行。如果行中保存了调用mysql_fetch_row()返回的值，将按照row[0]到row[mysql_num_fields(result)-1]，访问这些值的指针。
• 返回值：
  下一行的MYSQL_ROW结构。如果没有更多要检索的行或出现了错误，返回NULL。

（七）mysql_free_result()

• 语法：

void mysql_free_result(MYSQL_RES *result)

• 描述：
  释放由mysql_store_result()、mysql_use_result()、mysql_list_dbs()等为结果集分配的内存。完成对结果集的操作后,必须调用mysql_free_result()释放结果集使用的内存。
• 返回值：
  无 。

（八）mysql_error()

• 语法：

const char *mysql_error(MYSQL *mysql)

• 描述：
  对于由mysql指定的连接,对于失败的最近调用的API函数，mysql_error()返回包含错误消息的、由Null终结的字符串
  如果成功,，所有向服务器请求信息的函数均会复位mysql_error()。
• 返回值：
  返回描述错误的、由Null终结的字符串。如果未出现错误,返回空
  字符串。

（九）mysql_close()

• 语法：

void mysql_close(MYSQL *mysql)

• 描述：
  关闭前面打开的连接。如果句柄是由mysql_init()或mysql_connect()自动分配的,mysql_close()还将解除分配由mysql指向的连接句柄。
• 返回值：
  无 。

四、一个简单的C++程序

#include 
#include 
using namespace std;
MYSQL *conn;MYSQL_RES *res;MYSQL_ROW row;
int main(int argc,char **argv)
{
    const char *sever = "localhost"; //主机
    const char *user = "root"; //用户名
    const char *password = "XXXXXX"; //用户密码
    const char *database = "database_name"; //数据库名称
    conn = mysql_init(NULL);
    if(!mysql_real_connect(conn,sever,user,password,database,0,NULL,0))
    {
        cout << "connect error" << endl;
        return 0;
    }
    mysql_set_character_set(conn,"utf8");
    if(mysql_query(conn,"select * from emp"))
    {
        cout << "query error" << endl;
        return 0;
    }
    //res = mysql_store_result(conn);
    res = mysql_use_result(conn);
    while((row = mysql_fetch_row(res)) != NULL)
    {
        cout << row[0] << '\t' << row[1] << '\t' << row[2] << '\t' 
             << row[3] << '\t' << row[4] << endl;
    }
    mysql_free_result(res);
    mysql_close(conn);
    return 0;
}

显示结果：

显示结果.png