傳回結果集中的欄數。

您可以從結果集的指標或連線處理器取得欄數。如果 mysql_store_result() 或 mysql_use_result() 傳回 NULL（因此您沒有結果集指標），則會使用連線處理器。在這種情況下，您可以呼叫 mysql_field_count() 來判斷 mysql_store_result() 是否應產生非空結果。這讓用戶端程式可以在不知道查詢是否為 SELECT（或類似 SELECT）陳述式的狀況下採取適當的動作。此處顯示的範例說明如何執行此操作。

請參閱 第 3.6.9 節，〈mysql_query() 成功後傳回 NULL mysql_store_result()〉。

代表結果集中欄數的無號整數。

無。

MYSQL_RES *result;
unsigned int num_fields;
unsigned int num_rows;

if (mysql_query(&mysql,query_string))
{
    // error
}
else // query succeeded, process any data returned by it
{
    result = mysql_store_result(&mysql);
    if (result)  // there are rows
    {
        num_fields = mysql_num_fields(result);
        // retrieve rows, then call mysql_free_result(result)
    }
    else  // mysql_store_result() returned nothing; should it have?
    {
        if (mysql_errno(&mysql))
        {
           fprintf(stderr, "Error: %s\n", mysql_error(&mysql));
        }
        else if (mysql_field_count(&mysql) == 0)
        {
            // query does not return data
            // (it was not a SELECT)
            num_rows = mysql_affected_rows(&mysql);
        }
    }
}

另一種方法（如果您知道您的查詢應該傳回結果集）是將 mysql_errno(&mysql) 呼叫取代為檢查 mysql_field_count(&mysql) 是否傳回 0。只有在發生錯誤時才會發生這種情況。