NEXT_HTTP_VARIABLE function [HTTP]

Function

Get the next HTTP variable name.

Syntax

NEXT_HTTP_VARIABLEvar-name )

NoteCIS functional compensation performance considerations apply. See “Conditions that cause processing by SQL Anywhere” in Chapter 3, “Optimizing Queries and Deletions,” in the Performance and Tuning Guide.

Parameters

var-name The name of the previous variable. If var-name is null, this function returns the name of the first HTTP variable.

Usage

This function iterates over the HTTP variables included within a request. Calling it with NULL causes it to return the name of the first variable. Subsequent variables are retrieved by passing the function the name of the previous variable. This function returns NULL when called with the name of the final variable.

Calling this function repeatedly returns all the variables exactly once, but not necessarily in the order in which they appear in the HTTP request. The variables url or url1, url2, …, url10 are included if URL PATH is set to ON or ELEMENTS, respectively.

Standards and compatibility

See also

“HTML_DECODE function [HTTP]”

“HTTP_VARIABLE function [HTTP]”

“NEXT_HTTP_HEADER function [HTTP]”