可以從SELECT語句(或其他返回數據的語句)中檢索完所有數據,在單一調用中,使用mysql_store_result:
MYSQL_RES *mysql_store_result(MYSQL *connection);
必須在mysql_query檢索數據后才能調用這個函數,以在結果集中存儲該數據。這個函數從服務器中檢索所有數據并立即將它存儲在客戶機中。它返回一個指向以前我們從未遇到過的結構(結果集結構)的指針。如果語句失敗,則返回NULL。
使用等價的PostgreSQL時,應該知道返回NULL意味著已經發生了錯誤,并且這與未檢索到數據的情況不同。即使,返回值不是NULL,也不意味著當前有數據要處理。
如果未返回NULL,則可以調用mysql_num_rows并且檢索實際返回的行數,它當然可能是0。
my_ulonglong mysql_num_rows(MYSQL_RES *result);
它從mysql_store_result取得返回的結果結構,并且在該結果集中返回行數,行數可能為0。如果mysql_store_result成功,則mysql_num_rows也總是成功的。
這
種mysql_store_result和mysql_num_rows的組合是檢索數據的一種簡便并且直接的方法。一旦
mysql_store_result成功返回,則所有查詢數據都已經存儲在客戶機上并且我們知道可以從結果結構中檢索它,而不用擔心會發生數據庫或網絡
錯誤,因為對于程序所有數據都是本地的。還可以立即發現返回的行數,它可以使編碼更簡便。如前所述,它將所有結果立即地發送回客戶機。對于大結果集,它可
能耗費大量的服務器、網絡和客戶機資源。由于這些原因,使用更大的數據集時,最好僅檢索需要的數據。不久,我們將討論如何使用
mysql_use_result函數來完成該操作。
一旦檢索了數據,則可以使用mysql_fetch_row來檢索它,并且使用mysql_data_seek、mysql_row_seek、mysql_row_tell操作結果集。在開始檢索數據階段之前,讓我們先討論一下這些函數。
MYSQL_ROW mysql_fetch_row(MYSQL_RES *result);
這個函數采用從存儲結果中獲取的結果結構,并且從中檢索單一行,在行結構中返回分配給您的數據。當沒有更多數據或者發生錯誤時,返回NULL。稍后,我們將回來處理這一行中的數據。
void mysql_data_seek(MYSQL_RES *result, my_ulonglong offset);
這個函數允許您進入結果集,設置將由下一個獲取操作返回的行。offset是行號,它必須在從0到結果集中的行數減 1 的范圍內。傳遞0將導致在下一次調用mysql_fetch_row時返回第一行。
MYSQL_ROW_OFFEST mysql_row_tell(MYSQL_RES *result);
這個函數返回一個偏移值,它表示結果集中的當前位置。它不是行號,不能將它用于mysql_data_seek。但是,可將它用于:
MYSQL_ROW_OFFSET mysql_row_seek(MYSQL_RES *result, MYSQL_ROW_OFFSET offset);
它移動結果集中的當前位置,并返回以前的位置。
有時,這一對函數對于在結果集中的已知點之間跳轉很有用。請注意,不要將row tell和row seek使用的偏移值與data_seek使用的行號混淆。這些是不可交換的,結果將是您所希望看到的。
void mysql_free_result(MYSQL_RES *result);
完成結果集時, 必須總是調用這個函數,以允許MySQL庫整理分配給它的對象。
|
|