MySQL中遍历查询结果的常用API（c）

本中所使用的table：

 unsigned int mysql_errno(MYSQL *mysql) 

 const char *mysql_error(MYSQL *mysql) 

说明：一个函数是返回错误号，一个返回错误信息，两者都以MYSQL*为参数，很直观。

用到的函数：

int mysql_query(MYSQL *mysql, const char *stmt_str) 

int mysql_real_query(MYSQL *mysql, const char *stmt_str, unsigned longlength) 

返回值：成功则返回0，失败返回非零，如果失败的话，可以利用错误处理函数来获得错误信息。

这两个函数的区别：当查询语句使用的是二进制数据时，只能用后者。

用到的函数：

 MYSQL_RES *mysql_store_result(MYSQL *mysql) 

 MYSQL_RES *mysql_use_result(MYSQL *mysql) 

返回值：如果执行成功，返回一个非空的MYSQL_RES指针，否则，返回NULL。注意，只要执行select语句成功，就算没有与该select语句匹配的表项，该函数的返回值也不应为NULL。

两个函数的区别：mysql_store_result将整个result set放进client中存储，假若select的查询结果有一百个表项，则调用mysql_store_result会将这一百个表项全都存在了内存中，而mysql_use_result仅仅从result set中取出一个表项存在内存中，使用mysql_fetch_row()函数时才从server中的result set中取出下一个表项。因此mysql_use_result占用的内存更少执行速度也更快。但如果你需要在client端对result set的数据进行一些处理的话，那还是用mysql_store_set吧。

总结：mysql_store_result将select语句在server中的执行结果全都存到了client的内存中，而mysql_use_result仅当需要用到数据时才从server中取出下一条数据存到client的内存中。

注意：结果用完之后，要用mysql_free_result()释放内存。该函数的原型为 void mysql_free_result(MYSQL_RES *result) 

遍历结果可分为两个步骤：首先取出result set中的一行数据，然后再遍历该行数据中的每列数据。

遍历行时用到的函数：

 MYSQL_ROW mysql_fetch_row(MYSQL_RES *result) 

说明：它以上一步中的查询结果为参数，返回一个MYSQL_ROW结构体，这个结构体的内容为result set中的一行数据，可以理解为一个元素为字符指针的数组（char* row[elems])，当result set中的所有数据遍历完毕，该函数返回NULL。那么怎样使用这个结构体呢？首先得通过下面的函数(mysql_num_fields() / mysql_field_count())得到result set中的列数，然后从index从0开始，以（列数 - 1）结束，依此遍历就可以了。以col代指当前列，若当前列的值为NULL，MYSQL_ROW[col]的值也为NULL。

使用示例：

输出结果如下：

其实正常情况下应该对row[i]是否为NULL进行判断的，这里让我有点疑惑，为何row[i]在为空的情况下，也行正常printf出结果，而不产生段错误。

结果：

遍历列时用到的函数：

 unsigned int mysql_num_fields(MYSQL_RES *result) 

 unsigned int mysql_field_count(MYSQL *mysql) 

 MYSQL_FIELD *mysql_fetch_field(MYSQL_RES *result) 

对于前面两个函数，它们的参数不同，但是效果却是相同的，都是返回当前查询的result set中的列数。

通过第三个函数可以得到列的属性（包括列的name，列的type等信息），它的用法与mysql_fetch_col()差不多，也需要用while不停地循环。当返回值为空时，就代表没有下一列了。

使用示例：

结果： 

 全部代码