Db free result

db_free_result

Description:

Function db_free_result frees result memory allocated from db_query.

This function name starts with a lowercase letter.

Parameters:

(DBResult:dbresult)

int

dbresult

The result to free.

Return Values:

If DBResult:dbhandle is a valid handle, it returns 1, otherwise 0 if DBResult:dbhandle is a NULL reference.

Examples:

Example 1

// Example function
GetNameBySpawnID(spawn_id)
{
	// Declare "p_name"
	new p_name[MAX_PLAYER_NAME+1];
 
	// Declare "query" and "db_result"
	static query[60], DBResult:db_result;
 
	// Formats "query"
	format(query, sizeof query, "SELECT `PlayerName` FROM `spawn_log` WHERE `ID`=%d", spawn_id);
 
	// Selects the player name by using "spawn_id"
	db_result = db_query(db_handle, query);
 
	// If there is any valid entry
	if(db_num_rows(db_result))
	{
		// Store data from "PlayerName" into "p_name"
		db_get_field(db_result, 0, p_name, sizeof p_name);
	}
 
	// Frees the result
	db_free_result(db_result);
 
	// Returns "p_name"
	return p_name;
}

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_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.