knowledge.c File Reference

#include "global.h"
#include <assert.h>
#include <ctype.h>
#include <stdlib.h>
#include <string.h>
#include "sproto.h"
#include "output_file.h"

Include dependency graph for knowledge.c:

Go to the source code of this file.

Data Structures
struct	knowledge_item
struct	knowledge_player
struct	knowledge_type

Macros
#define	TAG_END   "[/color]"
#define	TAG_START   "[color=#ff6611]"

Typedefs
typedef int(*	knowledge_add_item) (struct knowledge_player *current, const char *item, const struct knowledge_type *type, player *pl)
typedef void(*	knowledge_attempt) (player *pl, const struct knowledge_item *item)
typedef StringBuffer *(*	knowledge_can_use_alchemy) (sstring code, const char *item, StringBuffer *buf, int index)
typedef void(*	knowledge_detail) (const char *code, StringBuffer *buf)
typedef const Face *(*	knowledge_face) (sstring code)
typedef int(*	knowledge_is_valid_item) (const char *code)
typedef struct knowledge_item	knowledge_item
typedef struct knowledge_player	knowledge_player
typedef void(*	knowledge_summary) (const char *code, StringBuffer *buf)
typedef struct knowledge_type	knowledge_type

Functions
void	command_knowledge (object *pl, const char *params)
void	free_knowledge (void)
static void	free_knowledge_items (knowledge_player *kp)
static void	free_knowledge_player (knowledge_player *kp)
static int	knowledge_add (knowledge_player *current, const char *item, const knowledge_type *kt, player *pl)
static void	knowledge_alchemy_attempt (player *pl, const knowledge_item *item)
static StringBuffer *	knowledge_alchemy_can_use_item (sstring code, const char *item, StringBuffer *buf, int index)
static void	knowledge_alchemy_detail (const char *value, StringBuffer *buf)
static const Face *	knowledge_alchemy_face (sstring code)
static const recipe *	knowledge_alchemy_get_recipe (const char *value)
static void	knowledge_alchemy_summary (const char *value, StringBuffer *buf)
static int	knowledge_alchemy_validate (const char *item)
static void	knowledge_display (object *pl, const char *params)
static void	knowledge_do_attempt (object *pl, const char *params)
static void	knowledge_do_display (object *pl, const knowledge_type *show_only, const char *search)
static const knowledge_type *	knowledge_find (const char *type)
void	knowledge_first_player_save (player *pl)
static knowledge_player *	knowledge_get_or_create (const player *pl)
void	knowledge_give (player *pl, const char *marker, const object *book)
static int	knowledge_god_add (struct knowledge_player *current, const char *item, const struct knowledge_type *type, player *pl)
static void	knowledge_god_detail (const char *item, StringBuffer *buf)
static const Face *	knowledge_god_face (sstring code)
static void	knowledge_god_summary (const char *item, StringBuffer *buf)
static int	knowledge_god_validate (const char *item)
void	knowledge_item_can_be_used_alchemy (object *op, const object *item)
static int	knowledge_known (const knowledge_player *current, const char *item, const knowledge_type *kt)
static void	knowledge_message_detail (const char *value, StringBuffer *buf)
static const Face *	knowledge_message_face (sstring code)
static void	knowledge_message_summary (const char *value, StringBuffer *buf)
static int	knowledge_message_validate (const char *item)
static int	knowledge_monster_add (struct knowledge_player *current, const char *item, const struct knowledge_type *type, player *pl)
static void	knowledge_monster_detail (const char *item, StringBuffer *buf)
static const Face *	knowledge_monster_face (sstring code)
static void	knowledge_monster_summary (const char *item, StringBuffer *buf)
static int	knowledge_monster_validate (const char *item)
int	knowledge_player_knows (const player *pl, const char *knowledge)
void	knowledge_process_incremental (void)
void	knowledge_read (player *pl, object *book)
static void	knowledge_read_player_data (knowledge_player *kp)
void	knowledge_send_info (socket_struct *ns)
void	knowledge_send_known (player *pl)
static void	knowledge_show (object *pl, const char *params)
void	knowledge_show_monster_detail (object *op, const char *name)
static void	knowledge_write_player_data (const knowledge_player *kp)

Variables
static knowledge_player *	knowledge_global = NULL
static const knowledge_type	knowledges []

Detailed Description

Handling of player knowledge of various things.

Right now, the following items are considered:

• alchemy formulea
• monster information
• god information (various types, like enemy, resistances, and such)
• messages in books, from the lib/messages file

Knowledge is specific for a player, and organized in 'items'. One item is a specific formulae or monster, whatever is coded.

Note that some things are done through functions in readable.c, especially item marking.

Knowledge is persistent and without errors. Maybe that could be changed in the future?

Only use non static functions when using this file.

Loading is done on a per-demand basis, writing at each change.

Knowledge is stored in a "player.knowledge" file in the player's directory.

Knowledge relies on key/values. Key is "knowledge_marker", value is specific to the item class considered and must have a left-side part, delimited by a double dot, specifying a type.

The value should be enough to determine a unique formulae or monster etc.

A type is linked to various functions for displaying, checking the key value.

During loading, obsolete items (eg formula changed) are discarded.

If the client has notifications support of at least 2, then knowledge information is sent as needed, incrementally as to not freeze the server.

Todo:

• make knowledge shareable between players
• more things to keep trace of

Definition in file knowledge.c.

Macro Definition Documentation

TAG_END

#define TAG_END   "[/color]"

Definition at line 70 of file knowledge.c.

Referenced by knowledge_give().

TAG_START

#define TAG_START   "[color=#ff6611]"

Definition at line 69 of file knowledge.c.

Referenced by knowledge_give().

Typedef Documentation

knowledge_add_item

typedef int(* knowledge_add_item) (struct knowledge_player *current, const char *item, const struct knowledge_type *type, player *pl)

Add knowledge information to the player's knowledge.

Parameters

current	where to add the information to.
item	what to add, format specific to the type.
type	pointer of the handler type.
pl	who we're adding the information for.

Returns

count of actually added items.

Definition at line 104 of file knowledge.c.

knowledge_attempt

typedef void(* knowledge_attempt) (player *pl, const struct knowledge_item *item)

Attempt an alchemy based on the specified knowledge.

Parameters

pl	who attempts the recipe.
item	item to attempt, must not be NULL.

Definition at line 130 of file knowledge.c.

knowledge_can_use_alchemy

typedef StringBuffer*(* knowledge_can_use_alchemy) (sstring code, const char *item, StringBuffer *buf, int index)

Check if an item can be used for a recipe, and fill the return buffer if it's the case.

Parameters

code	knowledge internal code.
item	item's name, including title if there is one.
buf	where to put the results. If NULL a new one can be allocated.
index	the knowledge index for this item.

Returns

buf, if it was NULL and the recipe uses the item, a new one is allocated.

Definition at line 114 of file knowledge.c.

knowledge_detail

typedef void(* knowledge_detail) (const char *code, StringBuffer *buf)

Function to fill the StringBuffer with a detailed description of an item.

Parameters

code	knowledge internal code.
buf	where to write the description, must not be NULL.

Definition at line 87 of file knowledge.c.

knowledge_face

typedef const Face*(* knowledge_face) (sstring code)

Get the face for a knowledge item.

Parameters

code	knowledge internal code.

Returns

face number, NULL for invalid.

Definition at line 121 of file knowledge.c.

knowledge_is_valid_item

typedef int(* knowledge_is_valid_item) (const char *code)

Function to check if the specified item is valid.

Parameters

code	knowledge internal code.

Returns

0 if invalid, non 0 if valid.

Definition at line 94 of file knowledge.c.

knowledge_item

typedef struct knowledge_item knowledge_item

One known item for a player.

knowledge_player

typedef struct knowledge_player knowledge_player

Information about a player.

knowledge_summary

typedef void(* knowledge_summary) (const char *code, StringBuffer *buf)

Function to fill the StringBuffer with the short description of an item.

Parameters

code	knowledge internal code.
buf	where to write the summary, must not be NULL.

Definition at line 80 of file knowledge.c.

knowledge_type

typedef struct knowledge_type knowledge_type

One item type that may be known to the player.

Function Documentation

command_knowledge()

void command_knowledge	(	object *	pl,
		const char *	params
	)

Handle the 'knowledge' for a player.

Parameters

pl	who is using the command.
params	additional parameters.

Definition at line 1238 of file knowledge.c.

References command_help(), knowledge_display(), knowledge_do_attempt(), knowledge_do_display(), knowledge_show(), llevError, and LOG().

Here is the call graph for this function:

free_knowledge()

void free_knowledge

(

void

)

Free all knowledge data.

Definition at line 1305 of file knowledge.c.

References free_knowledge_player(), knowledge_global, and knowledge_player::next.

Referenced by cleanup().

Here is the call graph for this function:

Here is the caller graph for this function:

free_knowledge_items()

static void free_knowledge_items ( knowledge_player *  kp )

static

Free all knowledge items for a player.

Parameters

kp	what to free.

Definition at line 1277 of file knowledge.c.

References free_string(), knowledge_item::item, knowledge_player::item_allocated, knowledge_player::item_count, and knowledge_player::items.

Referenced by free_knowledge_player().

Here is the call graph for this function:

Here is the caller graph for this function:

free_knowledge_player()

static void free_knowledge_player ( knowledge_player *  kp )

static

Totally free a knowledge structure, and its items.

Parameters

kp	structure to free, becomes invalid.

Definition at line 1296 of file knowledge.c.

References free_knowledge_items(), free_string(), and knowledge_player::player_name.

Referenced by free_knowledge(), and knowledge_process_incremental().

Here is the call graph for this function:

Here is the caller graph for this function:

knowledge_add()

static int knowledge_add ( knowledge_player *  current, const char *  item, const knowledge_type *  kt, player *  pl  )

static

Add a knowledge item to a player's store if not found yet.

Parameters

current	where to look for the knowledge.
item	internal value of the item to give, considered atomic.
kt	how to handle the knowledge type.
pl	who we're adding the information to.

Returns

0 if item was already known, 1 else.

Use malloc instead of calloc here. We're setting all relevant values, anyway.

Definition at line 573 of file knowledge.c.

References add_string(), knowledge_item::handler, knowledge_item::item, knowledge_player::item_allocated, knowledge_player::item_count, knowledge_player::items, and knowledge_known().

Referenced by knowledge_god_add(), and knowledge_monster_add().

Here is the call graph for this function:

Here is the caller graph for this function:

knowledge_alchemy_attempt()

static void knowledge_alchemy_attempt ( player *  pl, const knowledge_item *  item  )

static

Attempt an alchemy recipe through the knowledge system.

Parameters

pl	who is attempting the recipe.
item	knowledge item, should be of type recipe.

Definition at line 348 of file knowledge.c.

References apply_by_living_below(), recipestruct::cauldron, command_take(), draw_ext_info(), draw_ext_info_format(), examine(), FLAG_INV_LOCKED, FLAG_STARTEQUIP, recipestruct::ingred, recipestruct::ingred_count, knowledge_item::item, knowledge_alchemy_get_recipe(), llevError, LOG(), MAX_BUF, MSG_TYPE_COMMAND, MSG_TYPE_COMMAND_INFO, linked_char::name, knowledge_type::name, NDI_UNIQUE, linked_char::next, pl::ob, put_object_in_sack(), QUERY_FLAG, safe_strncpy, snprintf, and knowledge_type::use_alchemy.

Here is the call graph for this function:

knowledge_alchemy_can_use_item()

static StringBuffer* knowledge_alchemy_can_use_item ( sstring  code, const char *  item, StringBuffer *  buf, int  index  )

static

Check if an item can be used for a recipe, and fill the return buffer if it's the case.

Parameters

code	recipe internal code.
item	item's name, including title if there is one.
buf	where to put the results. If NULL a new one can be allocated.
index	the knowledge index for this item.

Returns

buf, if it was null and the recipe uses the item, a new one is allocated.

Definition at line 298 of file knowledge.c.

References recipestruct::arch_name, recipestruct::arch_names, buf, recipestruct::ingred, knowledge_alchemy_get_recipe(), linked_char::name, knowledge_type::name, linked_char::next, knowledge_player::next, RANDOM, stringbuffer_append_printf(), stringbuffer_append_string(), stringbuffer_new(), recipestruct::title, and try_find_archetype().

Here is the call graph for this function:

knowledge_alchemy_detail()

static void knowledge_alchemy_detail ( const char *  value, StringBuffer *  buf  )

static

Give the full description of the alchemy recpie.

Parameters

value	recipe internal value.
buf	where to store the detail.

Todo:

merge with stuff in readable.c

Definition at line 241 of file knowledge.c.

References recipestruct::arch_name, recipestruct::arch_names, recipestruct::cauldron, recipestruct::ingred, knowledge_alchemy_get_recipe(), MAX_BUF, linked_char::name, knowledge_type::name, linked_char::next, knowledge_player::next, query_name(), RANDOM, recipestruct::skill, snprintf, stringbuffer_append_printf(), recipestruct::title, and try_find_archetype().

Here is the call graph for this function:

knowledge_alchemy_face()

static const Face* knowledge_alchemy_face ( sstring  code )

static

Try to get a face for an alchemy recipe.

Parameters

code	alchemy code.

Returns

face, NULL if none could be found.

Definition at line 509 of file knowledge.c.

References recipestruct::arch_name, recipestruct::arch_names, arch_to_object(), blank_face, knowledge_type::face, give_artifact_abilities(), artifactstruct::item, knowledge_alchemy_get_recipe(), llevError, locate_recipe_artifact(), LOG(), object_free(), object_give_identified_properties(), recipestruct::title, and try_find_archetype().

Here is the call graph for this function:

knowledge_alchemy_get_recipe()

static const recipe* knowledge_alchemy_get_recipe ( const char *  value )

static

Get a recipe from the internal code.

Parameters

value

code to get value for.

Returns

recipe, NULL if not found.

Definition at line 173 of file knowledge.c.

References get_formulalist(), recipestruct::index, recipeliststruct::items, recipestruct::next, and recipestruct::title.

Referenced by knowledge_alchemy_attempt(), knowledge_alchemy_can_use_item(), knowledge_alchemy_detail(), knowledge_alchemy_face(), knowledge_alchemy_summary(), and knowledge_alchemy_validate().

Here is the call graph for this function:

Here is the caller graph for this function:

knowledge_alchemy_summary()

static void knowledge_alchemy_summary ( const char *  value, StringBuffer *  buf  )

static

Give the title of the alchemy recpie.

Parameters

value	recipe internal value.
buf	where to put the information.

Todo:

merge with stuff in readable.c

Definition at line 211 of file knowledge.c.

References recipestruct::arch_name, recipestruct::arch_names, knowledge_alchemy_get_recipe(), RANDOM, stringbuffer_append_printf(), recipestruct::title, and try_find_archetype().

Here is the call graph for this function:

knowledge_alchemy_validate()

static int knowledge_alchemy_validate ( const char *  item )

static

Check if an alchemy recipe is still ok.

Parameters

item	what to check for

Returns

0 if non valid, 1 else.

Definition at line 286 of file knowledge.c.

References knowledge_alchemy_get_recipe().

Here is the call graph for this function:

knowledge_display()

static void knowledge_display ( object *  pl, const char *  params  )

static

Display all a player's knowledge.

Parameters

pl	who to display knowledge of.
params	additionnal parameters.

Definition at line 1158 of file knowledge.c.

References draw_ext_info(), draw_ext_info_format(), knowledge_do_display(), MSG_TYPE_CLIENT_NOTICE, MSG_TYPE_MISC, knowledge_type::name, NDI_UNIQUE, and knowledge_type::type.

Referenced by command_knowledge().

Here is the call graph for this function:

Here is the caller graph for this function:

knowledge_do_attempt()

static void knowledge_do_attempt ( object *  pl, const char *  params  )

static

Player attempts something on a knowledge, get item and try it.

Parameters

pl	who is trying.
params	command parameters.

Definition at line 1214 of file knowledge.c.

References knowledge_type::attempt_alchemy, draw_ext_info(), knowledge_item::handler, knowledge_player::item_count, knowledge_player::items, knowledge_get_or_create(), MSG_TYPE_COMMAND, MSG_TYPE_COMMAND_INFO, and NDI_UNIQUE.

Referenced by command_knowledge().

Here is the call graph for this function:

Here is the caller graph for this function:

knowledge_do_display()

static void knowledge_do_display ( object *  pl, const knowledge_type *  show_only, const char *  search  )

static

Actually display knowledge list.

Parameters

pl	who to display to.
show_only	if not NULL, only display this knowledge type.
search	if not NULL, only display items having the summary or detail contain the string. Must be either NULL or a non empty string.

Definition at line 1093 of file knowledge.c.

References knowledge_type::detail, draw_ext_info(), draw_ext_info_format(), knowledge_item::handler, knowledge_item::item, knowledge_player::item_count, knowledge_player::items, knowledge_get_or_create(), MSG_TYPE_CLIENT_NOTICE, MSG_TYPE_MISC, knowledge_type::name, NDI_UNIQUE, stringbuffer_finish(), stringbuffer_new(), knowledge_type::summary, and knowledge_type::type.

Referenced by command_knowledge(), and knowledge_display().

Here is the call graph for this function:

Here is the caller graph for this function:

knowledge_find()

static const knowledge_type* knowledge_find ( const char *  type )

static

Find a knowledge handler from its type.

Parameters

type	internal type name.

Returns

handler, NULL if not found.

Definition at line 892 of file knowledge.c.

Referenced by knowledge_give(), knowledge_player_knows(), and knowledge_read_player_data().

Here is the caller graph for this function:

knowledge_first_player_save()

void knowledge_first_player_save

(

player *

pl

)

Ensure the knowledge state is correctly saved for the player. This function should only be called once, when the player's save directory is created. All other knowledge functions save the state automatically, but save can only happen when the player directory exists.

Parameters

pl	who to save the state for.

Definition at line 1448 of file knowledge.c.

References knowledge_global, knowledge_write_player_data(), knowledge_player::next, pl::ob, and knowledge_player::player_name.

Referenced by save_player().

Here is the call graph for this function:

Here is the caller graph for this function:

knowledge_get_or_create()

static knowledge_player* knowledge_get_or_create ( const player *  pl )

static

Find or create the knowledge store for a player. Will load data if required. fatal() will be called if memory failure.

Parameters

pl	who to find data for.

Returns

data store, never NULL.

Definition at line 993 of file knowledge.c.

References add_refcount(), fatal(), knowledge_global, knowledge_read_player_data(), knowledge_player::next, socket_struct::notifications, pl::ob, OUT_OF_MEMORY, knowledge_player::player_name, knowledge_player::sent_up_to, and pl::socket.

Referenced by knowledge_do_attempt(), knowledge_do_display(), knowledge_give(), knowledge_item_can_be_used_alchemy(), knowledge_player_knows(), knowledge_send_known(), knowledge_show(), and knowledge_show_monster_detail().

Here is the call graph for this function:

Here is the caller graph for this function:

knowledge_give()

void knowledge_give	(	player *	pl,
		const char *	marker,
		const object *	book
	)

Give a knowledge item from its code.

Parameters

pl	who to give the knowldge to.
marker	knowledge's code.
book	optional item containing the knowledge code.

Definition at line 1021 of file knowledge.c.

References knowledge_type::add, draw_ext_info_format(), fatal(), pl::has_directory, i18n(), knowledge_player::items, knowledge_find(), knowledge_get_or_create(), knowledge_write_player_data(), llevError, LOG(), MSG_TYPE_CLIENT_NOTICE, MSG_TYPE_MISC, NDI_UNIQUE, pl::ob, OUT_OF_MEMORY, TAG_END, TAG_START, knowledge_type::type, and knowledge_type::validate.

Referenced by cfapi_player_knowledge(), and knowledge_read().

Here is the call graph for this function:

Here is the caller graph for this function:

knowledge_god_add()

static int knowledge_god_add ( struct knowledge_player *  current, const char *  item, const struct knowledge_type *  type, player *  pl  )

static

Add god information to the player's knowledge, handling the multiple monster case.

Parameters

current	where to add the information to.
item	god to add, a dot separating the exact knowledge.
type	pointer of the monster type.
pl	who we're adding the information to.

Returns

count of actually added items.

Definition at line 753 of file knowledge.c.

References buf, free_string(), knowledge_item::handler, knowledge_item::item, knowledge_player::item_count, knowledge_player::items, knowledge_add(), llevError, LOG(), strdup_local, stringbuffer_append_printf(), stringbuffer_finish_shared(), and stringbuffer_new().

Here is the call graph for this function:

knowledge_god_detail()

static void knowledge_god_detail ( const char *  item, StringBuffer *  buf  )

static

Describe in detail a god.

Parameters

item	knowledge item for the god (object name and what is known).
buf	where to put the description.

Todo:

merge with stuff in readable.c

Definition at line 701 of file knowledge.c.

References describe_god(), find_archetype_by_object_name(), llevError, LOG(), and strdup_local.

Here is the call graph for this function:

knowledge_god_face()

static const Face* knowledge_god_face ( sstring  code )

static

Get the face for a god.

Parameters

code	god's code.

Returns

face, NULL if invalid.

Definition at line 799 of file knowledge.c.

References buf, MAX_BUF, snprintf, tolower, and try_find_archetype().

Here is the call graph for this function:

knowledge_god_summary()

static void knowledge_god_summary ( const char *  item, StringBuffer *  buf  )

static

God information summary.

Parameters

item	knowledge item.
buf	where to put the information.

Todo:

merge with stuff in readable.c

Definition at line 685 of file knowledge.c.

References strdup_local, and stringbuffer_append_printf().

Here is the call graph for this function:

knowledge_god_validate()

static int knowledge_god_validate ( const char *  item )

static

Check if a god knowledge item is still valid.

Parameters

item	monster to check

Returns

0 if invalid, 1 if valid.

Definition at line 730 of file knowledge.c.

References find_archetype_by_object_name(), llevError, LOG(), and strdup_local.

Here is the call graph for this function:

knowledge_item_can_be_used_alchemy()

void knowledge_item_can_be_used_alchemy	(	object *	op,
		const object *	item
	)

Displays known alchemy recipes an item can be used in.

Parameters

op	who to display recipes for.
item	what to check formulae for.

Definition at line 1359 of file knowledge.c.

References buf, draw_ext_info(), knowledge_item::handler, knowledge_item::item, knowledge_player::item_count, knowledge_player::items, knowledge_get_or_create(), MAX_BUF, MSG_TYPE_COMMAND, MSG_TYPE_COMMAND_EXAMINE, knowledge_type::name, NDI_UNIQUE, snprintf, stringbuffer_append_string(), stringbuffer_finish(), and knowledge_type::use_alchemy.

Referenced by examine().

Here is the call graph for this function:

Here is the caller graph for this function:

knowledge_known()

static int knowledge_known ( const knowledge_player *  current, const char *  item, const knowledge_type *  kt  )

static

Check whether a player already knows a knowledge item or not.

Parameters

current	player to check.
item	what to check for.
kt	the knowledge type for item.

Returns

0 if item is known, 1 else.

Definition at line 554 of file knowledge.c.

References knowledge_item::handler, knowledge_item::item, knowledge_player::item_count, knowledge_player::items, and knowledge_type::type.

Referenced by knowledge_add(), knowledge_player_knows(), and knowledge_show_monster_detail().

Here is the caller graph for this function:

knowledge_message_detail()

static void knowledge_message_detail ( const char *  value, StringBuffer *  buf  )

static

Give the full description of a message.

Parameters

value	message internal value.
buf	where to store the detail.

Todo:

merge with stuff in readable.c

Definition at line 843 of file knowledge.c.

References get_message_body(), get_message_from_identifier(), and stringbuffer_append_printf().

Here is the call graph for this function:

knowledge_message_face()

static const Face* knowledge_message_face ( sstring  code )

static

Get the face for a message.

Parameters

code	message's code.

Returns

face, NULL if invalid.

Definition at line 867 of file knowledge.c.

References get_message_face(), and get_message_from_identifier().

Here is the call graph for this function:

knowledge_message_summary()

static void knowledge_message_summary ( const char *  value, StringBuffer *  buf  )

static

Give the title of a message.

Parameters

value	message internal value.
buf	where to put the information.

Todo:

merge with stuff in readable.c

Definition at line 827 of file knowledge.c.

References get_message_from_identifier(), get_message_title(), and stringbuffer_append_printf().

Here is the call graph for this function:

knowledge_message_validate()

static int knowledge_message_validate ( const char *  item )

static

Check if a message is still valid.

Parameters

item	what to check for

Returns

0 if non valid, 1 else.

Definition at line 858 of file knowledge.c.

References get_message_from_identifier().

Here is the call graph for this function:

knowledge_monster_add()

static int knowledge_monster_add ( struct knowledge_player *  current, const char *  item, const struct knowledge_type *  type, player *  pl  )

static

Add monster information to the player's knowledge, handling the multiple monster case.

Parameters

current	where to add the information to.
item	monster to add, can be separated by dots for multiple ones.
type	pointer of the monster type.
pl	who we're adding the information to.

Returns

count of actually added items.

Definition at line 648 of file knowledge.c.

References knowledge_add(), and strdup_local.

Here is the call graph for this function:

knowledge_monster_detail()

static void knowledge_monster_detail ( const char *  item, StringBuffer *  buf  )

static

Describe in detail a monster.

Parameters

item	knowledge item for the monster (archetype name).
buf	where to put the description.

Todo:

merge with stuff in readable.c

Definition at line 618 of file knowledge.c.

References describe_item(), stringbuffer_append_printf(), and try_find_archetype().

Referenced by knowledge_show_monster_detail().

Here is the call graph for this function:

Here is the caller graph for this function:

knowledge_monster_face()

static const Face* knowledge_monster_face ( sstring  code )

static

Get the face for a monster.

Parameters

code	monster's code.

Returns

face, NULL if invalid.

Definition at line 670 of file knowledge.c.

References blank_face, and try_find_archetype().

Here is the call graph for this function:

knowledge_monster_summary()

static void knowledge_monster_summary ( const char *  item, StringBuffer *  buf  )

static

Monster information summary.

Parameters

item	knowledge item.
buf	where to put the information.

Todo:

merge with stuff in readable.c

Definition at line 604 of file knowledge.c.

References stringbuffer_append_printf(), and try_find_archetype().

Here is the call graph for this function:

knowledge_monster_validate()

static int knowledge_monster_validate ( const char *  item )

static

Check if a monster knowledge item is still valid.

Parameters

item	monster to check

Returns

0 if invalid, 1 if valid.

Definition at line 633 of file knowledge.c.

References try_find_archetype().

Here is the call graph for this function:

knowledge_player_knows()

int knowledge_player_knows	(	const player *	pl,
		const char *	knowledge
	)

Determines whether a player knows a specific knowledge or not.

Parameters

pl	who to check knowledge for.
knowledge	what to check for, in format "type:(type specific value)".

Returns

0 if item is known, 1 else.

Definition at line 1323 of file knowledge.c.

References knowledge_find(), knowledge_get_or_create(), knowledge_known(), llevError, LOG(), MAX_BUF, strlcpy(), and knowledge_type::type.

Referenced by cfapi_player_knowledge().

Here is the call graph for this function:

Here is the caller graph for this function:

knowledge_process_incremental()

void knowledge_process_incremental

(

void

)

Incrementally send knowledge information to players, and remove information for players who left.

Definition at line 1464 of file knowledge.c.

References buf, esrv_send_face(), knowledge_type::face, socket_struct::faces_sent, first_player, free_knowledge_player(), knowledge_item::handler, knowledge_item::item, knowledge_player::item_count, knowledge_type::item_face, knowledge_player::items, knowledge_global, MIN, pl::next, knowledge_player::next, NS_FACESENT_FACE, Face::number, pl::ob, knowledge_player::player_name, Send_With_Handling(), knowledge_player::sent_up_to, pl::socket, SockList_AddInt(), SockList_AddLen16Data(), SockList_AddString(), SockList_Avail(), SockList_Init(), SockList_Reset(), SockList_Term(), stringbuffer_finish(), stringbuffer_new(), knowledge_type::summary, try_find_face(), and knowledge_type::type.

Referenced by do_specials().

Here is the call graph for this function:

Here is the caller graph for this function:

knowledge_read()

void knowledge_read	(	player *	pl,
		object *	book
	)

Player is reading a book, give knowledge if needed, warn player, and such.

Parameters

pl	who is reading.
book	what is read.

Definition at line 1081 of file knowledge.c.

References knowledge_give(), and object_get_value().

Referenced by book_type_apply().

Here is the call graph for this function:

Here is the caller graph for this function:

knowledge_read_player_data()

static void knowledge_read_player_data ( knowledge_player *  kp )

static

Read all knowledge data for a player from disk, discarding invalid data.

Parameters

kp	player structure to load data into.

Definition at line 938 of file knowledge.c.

References add_string(), knowledge_item::handler, knowledge_item::item, knowledge_player::item_allocated, knowledge_player::item_count, knowledge_player::items, knowledge_find(), llevDebug, llevError, Settings::localdir, LOG(), MAX_BUF, knowledge_player::player_name, Settings::playerdir, settings, snprintf, knowledge_type::type, and knowledge_type::validate.

Referenced by knowledge_get_or_create().

Here is the call graph for this function:

Here is the caller graph for this function:

knowledge_send_info()

void knowledge_send_info

(

socket_struct *

ns

)

Send the reply_info for 'knowledge_info'.

Parameters

ns	socket to send information to.

Definition at line 1399 of file knowledge.c.

References knowledge_type::attempt_alchemy, esrv_send_face(), knowledge_type::face, socket_struct::faces_sent, knowledge_type::name, NS_FACESENT_FACE, Face::number, Send_With_Handling(), SockList_AddPrintf(), SockList_AddString(), SockList_Init(), SockList_Term(), try_find_face(), and knowledge_type::type.

Referenced by request_info_cmd().

Here is the call graph for this function:

Here is the caller graph for this function:

knowledge_send_known()

void knowledge_send_known

(

player *

pl

)

Send initial known knowledge to player, if requested.

Parameters

pl	who to send knowledge for.

Definition at line 1428 of file knowledge.c.

References knowledge_get_or_create(), socket_struct::notifications, knowledge_player::sent_up_to, and pl::socket.

Referenced by check_login().

Here is the call graph for this function:

Here is the caller graph for this function:

knowledge_show()

static void knowledge_show ( object *  pl, const char *  params  )

static

Show the details of a knowledge item.

Parameters

pl	who is asking for details.
params	additional parameters, should contain the knowledge item number.

Definition at line 1188 of file knowledge.c.

References buf, knowledge_type::detail, draw_ext_info(), knowledge_item::handler, knowledge_item::item, knowledge_player::item_count, knowledge_player::items, knowledge_get_or_create(), MSG_TYPE_CLIENT_NOTICE, MSG_TYPE_COMMAND, MSG_TYPE_COMMAND_INFO, MSG_TYPE_MISC, NDI_UNIQUE, stringbuffer_finish(), and stringbuffer_new().

Referenced by command_knowledge().

Here is the call graph for this function:

Here is the caller graph for this function:

knowledge_show_monster_detail()

void knowledge_show_monster_detail	(	object *	op,
		const char *	name
	)

Display the details of a monster if the player knows them.

Parameters

op	player asking for details.
name	monster's archetype name.

Definition at line 1553 of file knowledge.c.

References buf, draw_ext_info(), knowledge_get_or_create(), knowledge_known(), knowledge_monster_detail(), MSG_TYPE_COMMAND, MSG_TYPE_COMMAND_EXAMINE, NDI_UNIQUE, stringbuffer_finish(), and stringbuffer_new().

Referenced by examine_monster().

Here is the call graph for this function:

Here is the caller graph for this function:

knowledge_write_player_data()

static void knowledge_write_player_data ( const knowledge_player *  kp )

static

Store all knowledge data for a player to disk.

Parameters

kp	player data to store.

Todo:

rename/backup, stuff like that

Definition at line 907 of file knowledge.c.

References draw_ext_info(), knowledge_item::handler, knowledge_item::item, knowledge_player::item_count, knowledge_player::items, Settings::localdir, MAX_BUF, MSG_TYPE_ADMIN, MSG_TYPE_ADMIN_LOADSAVE, NDI_ALL_DMS, NDI_UNIQUE, of_close(), of_open(), knowledge_player::player_name, Settings::playerdir, settings, snprintf, and knowledge_type::type.

Referenced by knowledge_first_player_save(), and knowledge_give().

Here is the call graph for this function:

Here is the caller graph for this function:

Variable Documentation

knowledge_global

knowledge_player* knowledge_global = NULL

static

All known loaded knowledge for a player.

Definition at line 165 of file knowledge.c.

Referenced by free_knowledge(), knowledge_first_player_save(), knowledge_get_or_create(), and knowledge_process_incremental().

knowledges

const knowledge_type knowledges[]

static

Initial value:

= {
    { "alchemy", knowledge_alchemy_summary, knowledge_alchemy_detail, knowledge_alchemy_validate, knowledge_add, "recipes", knowledge_alchemy_can_use_item, knowledge_alchemy_attempt, "knowledge_recipes.111", knowledge_alchemy_face },
    { "monster", knowledge_monster_summary, knowledge_monster_detail, knowledge_monster_validate, knowledge_monster_add, "monsters", NULL, NULL, "knowledge_monsters.111", knowledge_monster_face },
    { "god", knowledge_god_summary, knowledge_god_detail, knowledge_god_validate, knowledge_god_add, "gods", NULL, NULL, "knowledge_gods.111", knowledge_god_face },
    { "message", knowledge_message_summary, knowledge_message_detail, knowledge_message_validate, knowledge_add, "messages", NULL, NULL, "knowledge_messages.111", knowledge_message_face },
    { NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL, NULL }
}

All handled knowledge items.

Definition at line 878 of file knowledge.c.