文件首頁
MySQL 8.4 C API 開發者指南
下載本手冊

5.4.52 mysql_num_fields()

unsigned int
mysql_num_fields(MYSQL_RES *result)

若要傳遞 MYSQL* 引數,請使用 unsigned int mysql_field_count(MYSQL *mysql)

說明

傳回結果集中欄位的數量。

您可以從結果集指標或連線處理程式取得欄位的數量。如果 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。只有在發生錯誤時才會發生這種情況。