获得下一个 HTTP 变量的名称。

语法

NEXT_HTTP_VARIABLE( var-name )

参数

返回值

LONG VARCHAR

注释

此函数对请求内包含的 HTTP 变量进行迭代。当使用 NULL 调用时，该函数返回第一个变量的名称。使用上一个变量名称调用该函数则可检索到后续的变量名称。使用最后一个变量的名称调用此函数或不是从 Web 服务进行调用时，此函数返回 NULL。

重复调用此函数时将会返回所有变量且仅返回一次，但返回的顺序不一定是它们在 HTTP 请求中出现的顺序。如果 URL PATH 分别设置为 ON 或 ELEMENTS，则包括变量 url 或 url1、url2、……、url10。

另请参见

• -xs 服务器选项
• 处理变量
• HTTP_DECODE 函数 [HTTP]
• HTTP_ENCODE 函数 [HTTP]
• HTTP_HEADER 函数 [HTTP]
• HTTP_VARIABLE 函数 [HTTP]
• NEXT_HTTP_HEADER 函数 [HTTP]
• SQL Anywhere Web 服务
• Web 服务函数
• Web 服务系统过程

标准和兼容性

示例

在由 HTTP Web 服务所调用的存储过程内，使用以下示例会返回第一个 HTTP 变量的名称。

BEGIN
DECLARE variable_name LONG VARCHAR;
SET variable_name = NULL;
SET variable_name = NEXT_HTTP_VARIABLE( variable_name )
END;