/*
==============================================================
CVAR
==============================================================
*/

/*

cvar_t variables are used to hold scalar or string variables that can be changed or displayed at the console or prog code as well as accessed directly
in C code.

The user can access cvars from the console in three ways:
r_draworder			prints the current value
r_draworder 0		sets the current value to 0
set r_draworder 0	as above, but creates the cvar if not present
Cvars are restricted from having the same names as commands to keep this
interface from being ambiguous.
*/

cvar_t *Cvar_Get(const char *var_name, const char *value, int flags, const char* desc);

/* creates the variable if it doesn't exist, or returns the existing one */
/* if it exists, the value will not be changed, but flags will be ORed in */
/* that allows variables to be unarchived without needing bitflags */

cvar_t *Cvar_Set(const char *var_name, const char *value);

/* will create the variable if it doesn't exist */

cvar_t *Cvar_ForceSet(const char *var_name, const char *value);

/* will set the variable even if NOSET or LATCH */

cvar_t *Cvar_FullSet(const char *var_name, const char *value, int flags);

void Cvar_SetValue(const char *var_name, float value);

/* expands value to a string and calls Cvar_Set */

int Cvar_VariableInteger(const char *var_name);

/* returns 0 if not defined or non numeric */

float Cvar_VariableValue(const char *var_name);

/* returns 0.0 if not defined or non numeric */

char *Cvar_VariableString(const char *var_name);

/* returns an empty string if not defined */

char *Cvar_VariableStringOld(const char *var_name);

/* returns an empty string if not defined */

int Cvar_CompleteVariable(const char *partial, const char **match);

/* attempts to match a partial variable name for command line completion */
/* returns NULL if nothing fits */

void Cvar_GetLatchedVars(void);

/* any CVAR_LATCHED variables that have been set will now take effect */

qboolean Cvar_Command(void);

/* called by Cmd_ExecuteString when Cmd_Argv(0) doesn't match a known */
/* command.  Returns true if the command was a variable reference that */
/* was handled. (print or change) */

void Cvar_WriteVariables(const char *path);

/* appends lines containing "set variable value" for all variables */
/* with the archive flag set to true. */

void Cvar_Init(void);

char *Cvar_Userinfo(void);

/* returns an info string containing all the CVAR_USERINFO cvars */

char *Cvar_Serverinfo(void);

/* returns an info string containing all the CVAR_SERVERINFO cvars */

extern qboolean userinfo_modified;

/* this is set each time a CVAR_USERINFO variable is changed */
/* so that the client knows to send it to the server */

qboolean Cvar_AssertValue(cvar_t * cvar, float minVal, float maxVal, qboolean shouldBeIntegral);

/* this function checks cvar ranges and integral values */

qboolean Cvar_AssertString(cvar_t * cvar, char **array, int arraySize);

/* this function checks whether the cvar string is a valid string in char ** array */

qboolean Cvar_SetCheckFunction(char *var_name, qboolean (*check) (void));

/* Sets the check functions for a cvar (e.g. Cvar_Assert) */