Project::OSiRiON - Git repositories
Project::OSiRiON
News . About . Screenshots . Downloads . Forum . Wiki . Tracker . Git
summaryrefslogtreecommitdiff
blob: f42eff7356f2dc6c82707caac1f943f88271b8cf (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
/*
   core/func.h
   This file is part of the Osirion project and is distributed under
   the terms of the GNU General Public License version 2
*/

#ifndef __INCLUDED_CORE_FUNC_H__
#define __INCLUDED_CORE_FUNC_H__

#include "core/player.h"
#include "core/entity.h"

#include <sstream>
#include <string>
#include <map>

namespace core
{

/// function pointer type for local functions
typedef void(* FuncPtr)(std::string const &args);

/// fuction pointer for game functions
typedef void(* GameFuncPtr)(Player *player, std::string const &args);

/// fuction pointer for target functions
typedef void(* TargetFuncPtr)(Player *player, Entity *entity);

/// a function pointer encapsulation class
class Func
{
public:
	/// function flags
	enum Flags {Game = 1, Shared = 2, Target = 4};

	/// create a new function
	Func(char const * name, void *ptr, unsigned int flags = 0);

	~Func();

	/*----- inspectors ------------------------------------------------ */

	/// returns the fucuntion flags
	inline unsigned int flags() const {
		return func_flags;
	}

	/// returns the name of the function
	inline std::string const &name() const {
		return func_name;
	}

	/// returns the info of the function
	inline std::string const &info() {
		return func_info;
	}

	/*----- mutators -------------------------------------------------- */

	/// set the info string
	void set_info(const char *);

	/// execute the function if the Game flag is not set
	void exec(std::string const &args);

	/// execute the function if the Game flag is set
	void exec(Player *player, std::string const &args);

	/// execute the function if the Target flag is set
	void exec(Player *player, Entity *entity);

	/* ---- Static functions for the Func registry -------------------- */

	/// type definition
	typedef std::map<std::string, Func*> Registry;

	/// add a function to the registry
	static Func *add(const char *name, FuncPtr functionptr, bool shared = false);

	/// add a game function to the registry and set the Game flag
	static Func *add(const char *name, GameFuncPtr functionptr);

	/// add a target function to the registry and set Game and Target flag
	static Func *add(const char *name, TargetFuncPtr targetfunctionptr);

	/// remove a function from the registry
	static void remove(const char *name);

	/// remove a function from the registry
	static void remove(std::string const &name);

	/// find a fuction pointer, return 0 if it could not be found
	static Func *find(std::string const &name);

	/// list the function registry
	static void list();

	/// the function registry
	static inline Registry & registry() {
		return func_registry;
	}

private:
	std::string		func_name;
	std::string		func_info;
	unsigned int 		func_flags;
	void 			*func_ptr;

	static Registry		func_registry;
};

}

#endif // __INCLUDED_CORE_FUNC_H__