Db num rows

From SA-MP Wiki

Jump to: navigation, search


Image:Farm-Fresh text lowercase.png Note: This function name starts with a lowercase letter.


Returns the number of rows from a db_query

DBResult:dbresultThe result of db_query

Return Values:

The number of rows in the result.



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:

// Example function
	// 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
		// Store data from "PlayerName" into "p_name"
		db_get_field(db_result, 0, p_name, sizeof p_name);
	// Frees the 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_num_rows: Get the number of rows 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_int: Get content of field as an integer with specified ID from current result row
  • db_get_field_float: Get content of field as a float with specified ID from current result row
Personal tools
In other languages