Hiscore handling functions. More...

#include "global.h"
#include <errno.h>
#include <string.h>
#include "sproto.h"
#include "output_file.h"

Include dependency graph for hiscore.c:

Data Structures
struct	score_table
	A highscore table. More...

struct	scr
	The score structure is used when treating new high-scores. More...

Typedefs
typedef struct scr	score
	The score structure is used when treating new high-scores. More...

Functions
static void	add_score (score_table table, score new_score, score *old_score)
	Adds the given score-structure to the high-score list, but only if it was good enough to deserve a place. More...

static char *	draw_one_high_score (const score sc, char buf, size_t size)
	Formats one score to display to a player. More...

static int	get_score (char bp, score sc)
	The opposite of put_score(), get_score reads from the given buffer into a static score structure, and returns a pointer to it. More...

void	hiscore_check (object *op, int quiet)
	Checks if player should enter the hiscore, and if so writes her into the list. More...

void	hiscore_display (object op, int max, const char match)
	Displays the high score file. More...

void	hiscore_init (void)
	Initializes the module. More...

static void	hiscore_load (score_table *table)
	Loads the hiscore_table from the highscore file. More...

static void	hiscore_save (const score_table *table)
	Saves the highscore_table into the highscore file. More...

static void	put_score (const score sc, char buf, size_t size)
	Writes the given score structure to specified buffer. More...

Variables
static score_table	hiscore_table
	The highscore table. More...

Detailed Description

Hiscore handling functions.

Definition in file hiscore.c.

Typedef Documentation

◆ score

typedef struct scr score

The score structure is used when treating new high-scores.

Function Documentation

◆ add_score()

static void add_score	(	score_table *	table,
		score *	new_score,
		score *	old_score
	)

static

Adds the given score-structure to the high-score list, but only if it was good enough to deserve a place.

Parameters

table	the highscore table to add to.
new_score	score to add.
old_score	returns the old player score.

Definition at line 181 of file hiscore.c.

References score_table::entry, scr::exp, HIGHSCORE_LENGTH, hiscore_save(), scr::name, and scr::position.

Referenced by hiscore_check().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ draw_one_high_score()

static char* draw_one_high_score	(	const score *	sc,
		char *	buf,
		size_t	size
	)

static

Formats one score to display to a player.

Parameters

sc	score to format.
buf	buffer to write to. Will contain suitably formatted score.
size	length of buf.

Returns: buf.

Definition at line 154 of file hiscore.c.

References scr::exp, FMT64, scr::killer, scr::maplevel, scr::maxgrace, scr::maxhp, scr::maxsp, scr::name, scr::position, snprintf, and scr::title.

Referenced by hiscore_check(), and hiscore_display().

Here is the caller graph for this function:

◆ get_score()

static int get_score	(	char *	bp,
		score *	sc
	)

static

The opposite of put_score(), get_score reads from the given buffer into a static score structure, and returns a pointer to it.

Parameters

bp	string to parse.
sc	returns the parsed score.

Returns: whether parsing was successful

Definition at line 109 of file hiscore.c.

References BIG_NAME, scr::exp, FMT64, scr::killer, scr::maplevel, scr::maxgrace, scr::maxhp, scr::maxsp, scr::name, split_string(), and scr::title.

Referenced by hiscore_load().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ hiscore_check()

void hiscore_check	(	object *	op,
		int	quiet
	)

Checks if player should enter the hiscore, and if so writes her into the list.

Parameters

op	player to check.
quiet	If set, don't print anything out - used for periodic updates during game play or when player unexpected quits - don't need to print anything in those cases

Note: check_score() has been renamed to hiscore_check()

Definition at line 302 of file hiscore.c.

References add_score(), BIG_NAME, obj::contr, draw_ext_info(), draw_one_high_score(), scr::exp, liv::exp, FLAG_WAS_WIZ, HIGHSCORE_LENGTH, scr::killer, pl::killer, obj::map, scr::maplevel, MAX_BUF, scr::maxgrace, liv::maxgrace, scr::maxhp, liv::maxhp, scr::maxsp, liv::maxsp, MSG_TYPE_ADMIN, MSG_TYPE_ADMIN_HISCORE, MSG_TYPE_APPLY, MSG_TYPE_APPLY_ERROR, MSG_TYPE_COMMAND, MSG_TYPE_COMMAND_ERROR, scr::name, obj::name, mapdef::name, pl::name_changed, NDI_UNIQUE, mapdef::path, player_get_title(), scr::position, QUERY_FLAG, obj::stats, and scr::title.

Referenced by apply_savebed(), command_kick2(), emergency_save(), key_confirm_quit(), kill_player_permadeath(), leave(), and process_players1().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ hiscore_display()

void hiscore_display	(	object *	op,
		int	max,
		const char *	match
	)

Displays the high score file.

Parameters

op	player asking for the score file.
max	maximum number of scores to display.
match	if non-empty, will only print players with name or title containing the string (non case-sensitive).