Main Page | Modules | Data Structures | Directories | File List | Data Fields | Globals

Variable list handling


Functions

const char * vars_get_value (vars_t *vs, const char *name)
 Get the value of the variable with given name.
var_tvars_get (vars_t *vs, const char *name)
 Get a variable with given name.
int vars_get_value_i (vars_t *vs, const char *name)
 Get the integer value of a variable with a given name.
u_string_t * vars_get_value_s (vars_t *vs, const char *name)
 Get u_string_t value of a variable.
var_tvars_geti (vars_t *vs, const char *name, size_t ith)
 Get i-th variable with given name.
const char * vars_geti_value (vars_t *vs, const char *name, size_t ith)
 Get the value of the variable at a given index.
int vars_geti_value_i (vars_t *vs, const char *name, size_t ith)
 Get the integer value of a variable with a given name and index.
u_string_t * vars_geti_value_s (vars_t *vs, const char *name, size_t ith)
 Get u_string_t value of i-th variable.
var_tvars_getn (vars_t *vs, size_t n)
 Get ith variable.
size_t vars_count (vars_t *vs)
 Count the number of variables.
size_t vars_countn (vars_t *vs, const char *name)
 Count the number of variables with given name.
void vars_foreach (vars_t *vs, int(*foreach)(var_t *, void *), void *arg)
 Execute a function on a list of variables.
int vars_add (vars_t *vs, var_t *v)
int vars_del (vars_t *vs, var_t *v)
int vars_add_strvar (vars_t *vs, const char *str)
int vars_add_urlvar (vars_t *vs, const char *cstr, var_t **v)
 Add an URL variable.

Detailed Description


Function Documentation

const char * vars_get_value vars_t *  vs,
const char *  name
 

Return the string value of the variable with name name in list vs.

Parameters:
vs variable list that is scanned
name variable name to search
Returns:
  • the value string corresponding to name
  • NULL if no value could be found

Definition at line 498 of file vars.c.

References vars_geti_value().

var_t * vars_get vars_t *  vs,
const char *  var_name
 

Return a var_t object with name name in list vs.

Parameters:
vs variable list
var_name variable name
Returns:
  • the var_t object found
  • NULL if there's no variable called var_name in vs

Definition at line 378 of file vars.c.

References vars_geti().

Referenced by request_get_arg(), request_get_cookie(), session_del(), session_get(), session_set(), and vars_get_value_s().

int vars_get_value_i vars_t *  vs,
const char *  name
 

Return the integer value of the variable with name name in list vs.

Parameters:
vs variable list
name variable name
Returns:
  • the integer value of name
  • 0 if no value could be found

Definition at line 452 of file vars.c.

References vars_geti_value_i().

u_string_t * vars_get_value_s vars_t *  vs,
const char *  name
 

Return an u_string_t containing the value of variable with name in variable list vs.

Parameters:
vs variable list
name name of variable
Returns:
the variable value (may be NULL)

Definition at line 79 of file vars.c.

References var_get_value_s(), and vars_get().

var_t * vars_geti vars_t *  vs,
const char *  var_name,
size_t  i
 

Return the var_t object at index i with name var_name in list vs.

Parameters:
vs variable list
var_name variable name
i index
Returns:
  • the var_t object found
  • NULL if there's no i-th variable called var_name in vs

Definition at line 346 of file vars.c.

References var_s::sname.

Referenced by vars_get(), vars_geti_value(), and vars_geti_value_s().

const char * vars_geti_value vars_t *  vs,
const char *  name,
size_t  ith
 

Return the string value of the variable with name name and index ith in list vs.

Parameters:
vs variable list that is scanned
name variable name to search
ith index of the searched variable
Returns:
  • the value string corresponding to name at i-th position
  • NULL if no value could be found

Definition at line 474 of file vars.c.

References var_get_value(), and vars_geti().

Referenced by vars_get_value(), and vars_geti_value_i().

int vars_geti_value_i vars_t *  vs,
const char *  name,
size_t  ith
 

Get the integer value of the variable with name name and index ith in list vs.

Parameters:
vs variable list
name variable name
ith index
Returns:
  • the integer value of name
  • 0 if no value could be found

Definition at line 400 of file vars.c.

References vars_geti_value().

Referenced by vars_get_value_i().

u_string_t * vars_geti_value_s vars_t *  vs,
const char *  name,
size_t  ith
 

Return an u_string_t containing the value of i-th variable with name in variable list vs.

Parameters:
vs variable list
name name of variable
ith index
Returns:
the variable value (may be NULL)

Definition at line 426 of file vars.c.

References var_get_value_s(), and vars_geti().

var_t * vars_getn vars_t *  vs,
size_t  i
 

Return the var_t at index i in list vs.

Parameters:
vs variable list
i index
Returns:
the ith variable or NULL if there's no ith var in vs

Definition at line 160 of file vars.c.

Referenced by session_clean().

size_t vars_count vars_t *  vs  ) 
 

Return a the number of variables in a list

Parameters:
vs variable list
Returns:
the number of elements in vs

Definition at line 186 of file vars.c.

size_t vars_countn vars_t *  vs,
const char *  name
 

Return a the number of variables in a list with given name name

Parameters:
vs variable list
name name of the variables to count
Returns:
the number of elements in vs whose name is name

Definition at line 203 of file vars.c.

References var_s::sname.

void vars_foreach vars_t *  vs,
int(*)(var_t *, void *)  cb,
void *  arg
 

Execute function cb with optional arguments arg on all variables in list vs

Parameters:
vs variable list
cb function to be called on each variable (see prototype)
arg argument to cb
Returns:
nothing

Definition at line 518 of file vars.c.

int vars_add_urlvar vars_t *  vs,
const char *  cstr,
var_t **  v
 

Parse the "name=value" string cstr, url-decode name and value and push it into vs. The variable is returned at *v.

Parameters:
vs variables' list where the variable is pushed
cstr URL string to parse
v the generated variable as a value-result argument
Returns:
0 if successful, non-zero on error

Definition at line 231 of file vars.c.

References u_urlncpy(), and vars_add().