[Top] [Prev] [Next] [Bottom] [Contents]

SaGetKeyedArg

 Retrieves the value of a key-value pair, that was stored in an anchor.

Synopsis

#include "SaRnHtml.h"
char* SaGetKeyedArg(char* key);

Arguments

key
A string specifying the key. If NULL or an empty string, NULL is returned.

Return Values

 Returns a stored value for the given key. This data must not be free'd or modified. Returns NULL if the key is not found.

Description

Retrieves the value of a key-value pair, that was stored in an anchor. Keyed strings are key-value pairs separated by an equal sign. Each keyed string printed is separated from the next keyed string by 3 underscores. This can be used to hold state for an anchor in a client browser. The data site should precede the bound anchor string.

Example

char* value;
value = SaGetKeyedArg("COOKIE");

See Also

[Top] [Prev] [Next] [Bottom] [Contents]

info@bluestone.com
Copyright © 1997, Bluestone. All rights reserved.