console_internal.h File Reference

Internally used functions for the console. More...

#include "console_type.h"

Go to the source code of this file.

Data Structures

struct  IConsoleCmd
struct  IConsoleAlias
 --Aliases-- Aliases are like shortcuts for complex functions, variable assignments, etc. More...

Typedefs

typedef bool IConsoleCmdProc (byte argc, char *argv[])
 --Commands-- Commands are commands, or functions.
typedef bool IConsoleHook ()

Enumerations

enum  { ICON_CMDLN_SIZE = 1024, ICON_MAX_STREAMSIZE = 2048 }

Functions

void IConsoleClearBuffer ()
void IConsoleCmdRegister (const char *name, IConsoleCmdProc *proc, IConsoleHook *hook=NULL)
 Register a new command to be used in the console.
void IConsoleAliasRegister (const char *name, const char *cmd)
 Register a an alias for an already existing command in the console.
IConsoleCmdIConsoleCmdGet (const char *name)
 Find the command pointed to by its string.
IConsoleAliasIConsoleAliasGet (const char *name)
 Find the alias pointed to by its string.
void IConsoleStdLibRegister ()
bool GetArgumentInteger (uint32 *value, const char *arg)
 Change a string into its number representation.
void IConsoleGUIInit ()
void IConsoleGUIFree ()
void IConsoleGUIPrint (ConsoleColour colour_code, char *string)
 Handle the printing of text entered into the console or redirected there by any other means.

Variables

IConsoleCmd_iconsole_cmds
 list of registred commands
IConsoleAlias_iconsole_aliases
 list of registred aliases

Detailed Description

Internally used functions for the console.

Definition in file console_internal.h.


Typedef Documentation

typedef bool IConsoleCmdProc(byte argc, char *argv[])

--Commands-- Commands are commands, or functions.

They get executed once and any effect they produce are carried out. The arguments to the commands are given to them, each input word seperated by a double-quote () is an argument If you want to handle multiple words as one, enclose them in double-quotes eg. 'say "hello sexy boy"'

Definition at line 29 of file console_internal.h.


Enumeration Type Documentation

anonymous enum
Enumerator:
ICON_CMDLN_SIZE 

maximum length of a typed in command

ICON_MAX_STREAMSIZE 

maximum length of a totally expanded command

Definition at line 17 of file console_internal.h.


Function Documentation

bool GetArgumentInteger ( uint32 *  value,
const char *  arg 
)

Change a string into its number representation.

Supports decimal and hexadecimal numbers as well as 'on'/'off' 'true'/'false'

Parameters:
*value the variable a successful conversion will be put in
*arg the string to be converted
Returns:
Return true on success or false on failure

Definition at line 177 of file console.cpp.

IConsoleAlias* IConsoleAliasGet ( const char *  name  ) 

Find the alias pointed to by its string.

Parameters:
name alias to be found
Returns:
return Aliasstruct of the found alias, or NULL on failure

Definition at line 290 of file console.cpp.

References IConsoleAlias::name, and IConsoleAlias::next.

Referenced by IConsoleCmdExec().

void IConsoleAliasRegister ( const char *  name,
const char *  cmd 
)

Register a an alias for an already existing command in the console.

Parameters:
name name of the alias that will be used
cmd name of the command that 'name' will be alias of

Definition at line 272 of file console.cpp.

References IConsoleAlias::cmdline, IConsoleAddSorted, IConsoleAlias::name, and IConsoleAlias::next.

IConsoleCmd* IConsoleCmdGet ( const char *  name  ) 

Find the command pointed to by its string.

Parameters:
name command to be found
Returns:
return Cmdstruct of the found command, or NULL on failure

Definition at line 257 of file console.cpp.

References IConsoleCmd::name, and IConsoleCmd::next.

Referenced by IConsoleCmdExec().

void IConsoleCmdRegister ( const char *  name,
IConsoleCmdProc proc,
IConsoleHook *  hook 
)

Register a new command to be used in the console.

Parameters:
name name of the command that will be used
proc function that will be called upon execution of command

Definition at line 241 of file console.cpp.

References IConsoleCmd::hook, IConsoleAddSorted, IConsoleCmd::name, IConsoleCmd::next, and IConsoleCmd::proc.

void IConsoleGUIPrint ( ConsoleColour  colour_code,
char *  str 
)

Handle the printing of text entered into the console or redirected there by any other means.

Text can be redirected to other clients in a network game as well as to a logfile. If the network server is a dedicated server, all activities are also logged. All lines to print are added to a temporary buffer which can be used as a history to print them onscreen

Parameters:
colour_code the colour of the command. Red in case of errors, etc.
str the message entered or output on the console (notice, error, etc.)

Definition at line 479 of file console_gui.cpp.

References SetWindowDirty().

Referenced by IConsolePrint().


Generated on Sun Nov 14 14:42:01 2010 for OpenTTD by  doxygen 1.6.1