#include <global.h>
#include <unistd.h>

Include dependency graph for region.c:

Functions
static void	assign_region_parents (void)

object *	get_jail_exit (object *op)

const char *	get_name_of_region_for_map (const mapstruct *m)

region *	get_region_by_map (mapstruct *m)

region *	get_region_by_name (const char *region_name)

region *	get_region_from_string (const char *name)

const char *	get_region_longname (const region *r)

const char *	get_region_msg (const region *r)

region *	get_region_struct (void)

void	init_regions (void)

static void	parse_regions (FILE *fp)

int	region_is_child_of_region (const region child, const region r)

Detailed Description

Region management.

A region is a group of maps. It includes a "parent" region.

Definition in file region.c.

Function Documentation

static void assign_region_parents ( void )

static

Links child with their parent from the parent_name field.

Definition at line 469 of file region.c.

References first_region, get_region_by_name(), llevDebug, LOG(), regiondef::next, regiondef::parent, regiondef::parent_name, and region_count.

Referenced by init_regions().

Here is the call graph for this function:

Here is the caller graph for this function:

object* get_jail_exit ( object * op )

Returns an object which is an exit through which the player represented by op should be sent in order to be imprisoned. If there is no suitable place to which an exit can be constructed, then NULL will be returned. The caller is responsible for freeing the object created by this function.

Parameters

op	Object we want to jail. Must be a player.

Returns: exit to jail, or NULL, in which case a message is LOG()ged .

Definition at line 272 of file region.c.

References add_string(), EXIT_PATH, EXIT_X, EXIT_Y, FLAG_DAMNED, get_object(), get_region_by_map(), regiondef::jailmap, regiondef::jailx, regiondef::jaily, llevDebug, llevError, LOG(), obj::map, regiondef::name, regiondef::parent, PLAYER, SET_FLAG, and obj::type.

Referenced by command_arrest().

Here is the call graph for this function:

Here is the caller graph for this function:

const char* get_name_of_region_for_map ( const mapstruct * m )

Gets the name of a region for a map.

Since we won't assume all maps have a region set properly, we need an explicit check that it is, this is much nicer here than scattered throughout the map code.

Parameters

m map

Returns

region's name if map has a region
if no region is set for the map, returns the first region with the 'fallback' property
if no fallback region, LOG()s an info message and returns "unknown".

Definition at line 103 of file region.c.

References regiondef::fallback, first_region, llevInfo, LOG(), regiondef::name, mapdef::name, regiondef::next, and mapdef::region.

Referenced by current_region_info(), get_region_by_map(), and get_who_escape_code_value().

Here is the call graph for this function:

Here is the caller graph for this function:

region* get_region_by_map ( mapstruct * m )

Gets a region from a map.

Parameters

m	map we want the region of.

Returns: region.

Todo:: This might need optimising at some point.

Definition at line 85 of file region.c.

References get_name_of_region_for_map(), and get_region_by_name().

Referenced by add_region_link(), cfapi_map_get_map_property(), command_whereabouts(), current_map_info(), enter_random_map(), enter_random_template_map(), get_jail_exit(), get_who_escape_code_value(), list_players(), and process_map().

Here is the call graph for this function:

Here is the caller graph for this function:

region* get_region_by_name ( const char * region_name )

Gets a region by name.

Used by the map parsing code.

Parameters

region_name name of region.

Returns

matching region
if no match, returns the first region with the 'fallback' property set and LOG()s to debug.
if it can't find a matching name and a fallback region it LOG()s an info message and returns NULL.

Definition at line 57 of file region.c.

References regiondef::fallback, first_region, llevDebug, llevInfo, LOG(), regiondef::name, and regiondef::next.

Referenced by assign_region_parents(), current_region_info(), get_region_by_map(), and load_map_header().

Here is the call graph for this function:

Here is the caller graph for this function:

region* get_region_from_string ( const char * name )

Tries to find a region that 'name' corresponds to. It looks, in order, for:

an exact match to region name (case insensitive)
an exact match to longname (case insensitive)
a substring that matches to the longname (eg Kingdom)
a substring that matches to the region name (eg nav)
if it can find none of these it returns the first parentless region (there should be only one of these - the top level one) If we got a NULL, then just return the top level region

Parameters

name	region we're searching. Can be NULL.

Returns: matching region.

Definition at line 132 of file region.c.

References first_region, regiondef::longname, regiondef::name, regiondef::next, regiondef::parent, and strcasecmp().

Referenced by command_who().

Here is the call graph for this function:

Here is the caller graph for this function:

const char* get_region_longname ( const region * r )

Gets the longname of a region.

The longname of a region is not a required field, any given region may want to not set it and use the parent's one instead.

Parameters

r	region we're searching the longname.

Returns

if a longname is set return it.
if there is a parent, call the function against that
if all fails, return a obviously wrong string if we can't get a longname, this should never happen. We also LOG() a debug message.

Definition at line 229 of file region.c.

References get_region_longname(), llevDebug, LOG(), regiondef::longname, regiondef::name, and regiondef::parent.

Referenced by command_whereabouts(), current_map_info(), current_region_info(), get_region_longname(), get_who_escape_code_value(), write_map_page(), write_region_index(), and write_region_page().

Here is the call graph for this function:

Here is the caller graph for this function:

const char* get_region_msg ( const region * r )

Gets a message for a region.

Parameters

r	region. Can't be NULL.

Returns

region's message if set
message of parent else
obviously wrong message if no parent, and we LOG() a debug message.

Definition at line 250 of file region.c.

References get_region_msg(), llevDebug, LOG(), regiondef::msg, regiondef::name, and regiondef::parent.

Referenced by current_region_info(), get_region_msg(), and write_region_page().

Here is the call graph for this function:

Here is the caller graph for this function:

region* get_region_struct ( void )

Allocates and zeros a region struct, this isn't free()'d anywhere, so might be a memory leak, but it shouldn't matter too much since it isn't called that often....