Documentation Home

5.4.20 mysql_fetch_lengths()

unsigned long *
mysql_fetch_lengths(MYSQL_RES *result)

描述

返回结果集中当前行的列的长度。如果您打算复制字段值,此长度信息对于优化也很有用,因为您可以避免调用strlen(). 此外,如果结果集包含二进制数据,则 必须使用此函数来确定数据的大小,因为 strlen()对于包含空字符的任何字段都会返回不正确的结果。

空列和包含 NULL值的列的长度为零。要了解如何区分这两种情况,请参阅 的说明 mysql_fetch_row()

返回值

表示每列大小的无符号长整数数组(不包括任何终止空字节)。 NULL如果发生错误。

错误

mysql_fetch_lengths()仅对结果集的当前行有效。NULL如果您在调用之前 mysql_fetch_row()或检索结果中的所有行之后 调用它,它就会返回 。

例子

MYSQL_ROW row;
unsigned long *lengths;
unsigned int num_fields;
unsigned int i;

row = mysql_fetch_row(result);
if (row)
{
    num_fields = mysql_num_fields(result);
    lengths = mysql_fetch_lengths(result);
    for(i = 0; i < num_fields; i++)
    {
         printf("Column %u is %lu bytes in length.\n",
                i, lengths[i]);
    }
}