Db next row
From SA-MP Wiki
db_next_row
Note: This function name starts with a lowercase letter. |
Description:
Moves to the next row of the result allocated from db_query.
(DBResult:dbresult)
DBResult:dbresult | The result of db_query. |
Return Values:
Returns 1 on success, otherwise 0 if DBResult:dbresult is a NULL reference or the last row is reached.
Warning | Using an invalid handle will crash your server! Get a valid handle by using db_query. But it's protected against NULL references. |
Example Usage:
// Callback public OnPlayerCommandText(playerid, cmdtext[]) { // If "cmdtext" equals "/EchoWoetJoinList" if(!strcmp(cmdtext, "/EchoWoetJoinList", true, 17)) { // Declare "db_result" and "info" new DBResult:db_result, info[2][30]; // Select the join list of the player "Woet" db_result = db_query(db_handle, "SELECT * FROM `join_log` WHERE `name`='Woet'"); // Do these do { // Store the data of "ip" into "info[0]" db_get_field_assoc(db_result, "ip", info[0], sizeof info[]); // Store the data of "time" into "info[1]" db_get_field_assoc(db_result, "time", info[1], sizeof info[]); // Print into the console printf("Print join list: Name: Woet IP: %s Date: %s", info[0], info[1]); } // While next row has been fetched while(db_next_row(db_result)); // Returns 1 return 1; } // Returns 0 return 0; }
Related Functions
The following functions may be useful, as they are related to this function in one way or another.
- db_open: Open a connection to an SQLite database
- db_close: Close the connection to an SQLite database
- db_query: Query an SQLite database
- db_free_result: Free result memory from a db_query
- db_num_rows: Get the number of rows in a result
- db_next_row: Move to the next row
- db_num_fields: Get the number of fields in a result
- db_field_name: Returns the name of a field at a particular index
- db_get_field: Get content of field with specified ID from current result row
- db_get_field_assoc: Get content of field with specified name from current result row
- db_get_field_int: Get content of field as an integer with specified ID from current result row
- db_get_field_assoc_int: Get content of field as an integer with specified name from current result row
- db_get_field_float: Get content of field as a float with specified ID from current result row
- db_get_field_assoc_float: Get content of field as a float with specified name from current result row
- db_get_mem_handle: Get memory handle for an SQLite database that was opened with db_open.
- db_get_result_mem_handle: Get memory handle for an SQLite query that was executed with db_query.