loadrunner Web_类函数之web_convert_param（）

web_convert_param（）--常用函数

将HTML转换为URL或纯文本。--比较常用
int web_convert_param（const char * ParamName，[char * SourceString] char * SourceEncoding，char *TargetEncoding，LAST）;
 参数说明:
ParamName:参数的名称。转换后的字符串将保存在此参数中。如果不使用SourceString，它最初包含要转换的文本。请注意，这不是名称/值对。仅传递参数的名称。
SourceString:要转换的文字字符串。“SourceString = your text”
SourceEncoding:源数据的编码类型：HTML，URL或纯文本，格式为：
            “SourceEncoding= HTML”
            “SourceEncoding= URL”或
            “SourceEncoding= PLAIN”
TargetEncoding:目标数据格式：URL，HTML或纯文本，格式为：
           “TargetEncoding = URL”
           “TargetEncoding =HTML”或
           “TargetEncoding =PLAIN”
LAST:指示参数列表结束的标记。
一般信息:
web_convert_param函数将HTML文本转换为纯文本或URL，或将纯文本转换为URL。
如果未传递SourceString，则会转换参数ParamName中的文本，并且结果将覆盖参数值。如果传递SourceString，源字符串将被转换并存储在参数ParamName中。
SourceString可以包含参数。首先评估源字符串，使用其值替换参数，然后进行转换。结果存储在参数ParamName中。
HTML格式使用一些非字母数字字符的代码，例如＆amp;为＆符。 URL不支持非字母数字字符，并使用转义序列％number来表示它们。要在URL中使用HTML值，您必须将其转换为转义序列或纯文本。例如，＆符号在URL中表示为％26。当您使用此函数将HTML转换为纯文本时，它会将其转换为字符在浏览器中的显示方式。
下表显示了HTML，URL和纯文本格式的相同内容：
 HTML URL纯文本
＆lt; mytag＆gt;＆amp; ％3Cmytag％3E％26 <mytag>＆
当您从HTML文档中检索URL，并且希望在HTTP请求（如web_custom_request）中使用此URL时，此函数非常有用。

 

在示例1中，web_convert_param将HTML字符串转换为URL和纯文本格式。示例2显示了SourceString参数的使用。
实施例1:
以下示例使用web_convert_param将HTML字符串转换为URL和纯文本格式。
网页有这些文本：
要转换的示例HTML代码：<mytag>＆End
要转换的样本纯文本：1-AD X = 0 + 2结束

Action()

{

web_reg_save_param("HTML",

   "LB=Sample HTML code to be converted: ",

   "RB= End",

   LAST );

 

web_reg_save_param("HTML1",

   "LB=Sample HTML code to be converted: ",

   "RB= End",

   LAST );

 

web_reg_save_param("Plaintext",

   "LB=Sample plain text to be converted: ",

   "RB= End",

   LAST );

 

web_url("web_url",

   "URL=http://lazyboy/html/convert_param_page.html",

    "TargetFrame=",

   "Resource=0",

    "Referer=",

    LAST );

 

web_convert_param("HTML","SourceEncoding=HTML",

    "TargetEncoding=URL", LAST );

web_convert_param("HTML1","SourceEncoding=HTML",

    "TargetEncoding=PLAIN", LAST );

web_convert_param("Plaintext","SourceEncoding=HTML",

    "TargetEncoding=URL", LAST );

 

web_reg_save_param("Result",

   "LB=<code>entry = ",

   "RB=</code>",

   LAST );

 

web_custom_request("web_custom_request",

   "URL=http://lazarus/cgi–bin/post_query.exe",

   "Method=POST",

   "TargetFrame=",

   "Resource=0",

   "Referer=",

   "Body=entry={Plaintext},{HTML}",

   LAST );

return 0;

}

以下部分显示运行上述段导致的日志文件的相关部分：
Running Vuser...

Action.c(21): Saving Parameter "HTML =&lt;mytag&gt;&amp;"

Action.c(21): Saving Parameter "HTML1= &lt;mytag&gt;&amp;"

Action.c(21): Saving Parameter"Plaintext = 1–AD X=0+2"

After web_url:

Action.c(28): Saving Parameter "HTML =%3Cmytag%3E%26"

Action.c(28): web_convert_param wassuccessful

Action.c(29): Saving Parameter "HTML1= <mytag>&"

Action.c(29): web_convert_param wassuccessful

Action.c(30): Saving Parameter"Plaintext = 1–AD+X%3D0%2B2"

Action.c(30): web_convert_param wassuccessful

web_custom_request:

Action.c(37): Parameter Substitution:parameter "Plaintext" = "1–AD+X%3D0%2B2"

Action.c(37): Parameter Substitution:parameter "HTML" = "%3Cmytag%3E%26"

Action.c(37): Saving Parameter "Result= 1–AD X=0+2,<mytag>&"

 

实施例2
此示例显示了使用SourceString参数。请注意，源字符串可以包含参数。首先评估源字符串，使用其值替换参数，然后转换为PLAIN。结果存储在参数“targetParam”中。
web_convert_param（
        “targetParam”，
        “SourceString ={param1} abc {param2}”，
        “SourceEncoding =HTML”，
        “TargetEncoding =PLAIN”，
         LAST）;

 

下面也是一个实例：