websGetVar -- GoAhead WebServer API

websGetVar

GoAhead WebServer API

GoAhead EMF

Synopsis

Return the value of a Form variable.

Prototype

 #include "webs.h" 

 char_t *websGetVar(webs_t wp, char_t *var, char_t *default);

Parameters

wp	Web server connection handle.
var	The form variable to be returned.
default	The variable to be returned if none is defined in var.

Description

The websGetVar procedure looks up var in the Form table of variables. If the variable is not defined, the value of the default is returned. If default is NULL and the variable is not found, NULL will be returned. Form variables are created for each <input> form tag. The standard form variables are also defined.

Return Value

Returns a pointer to a statically allocated string. Do not call bfree.

Example

 
name = websGetVar(wp, "Name", "Peter Smith");

Stability Classification

Stable.