LoadRunner通用函数详解(中文)(精品文档)-共3页.pdf

脚本运行相关

lr_get_vuser_ip

作用

获取虚拟用户IP。

返回值

成功，返回虚拟用户的IP指针；
失败，返回NULL.

参数

无

例子

Action()
{
char*ip;
ip=lr_get_vuser_ip();
if(ip)
lr_output_message("TheIPaddressis%s",ip);
else
lr_output_message("IPspoofingdisabled");
}

lr_vuser_status_message

作用

该函数将消息发送到消息到vuser状态区域，同时还将该字符串发送到vuser日志

返回值

成功，0；
失败，-1说明事务名称非法或者没有调用lr_start_transaction

参数

（格式化输出）

例子

lr_vuser_status_message("Weareoniteration#%s",lr_eval_string("{iteration}"));

lr_continue_on_error

作用

指定错误处理的方法

返回值

无

参数

（intvalue）
0：取消出错继续执行设置
1：发生错误继续运行脚本
2：发生错误跳至下个Action运行
3：发生错误跳至下一迭代来运行
4：发生错误结束当前用户

例子

//对于夜间执行的场景（一般会打开Continueonerror选项）。一些非关键业务，则需要通
过lr_continue_on_error(1)开启Continueonerror选项，这样即使遇到错误也不会影响脚本
的继续执行。但是对于关键业务，就需要关闭该项，使一些关键业务在出错时能够停止执
行。
//反之，如果在Run-timeSettings中没有勾选Continueonerror项，则应该通过组合使用
lr_continue_on_error(1)与lr_continue_on_error(0)来使一些非关键业务发生错误后继续执行

Action()
{
……
……
lr_continue_on_error(0);//下面是一些重要事务代码，因此关闭出错继续执行设置
……
……
lr_continue_on_error(1);//后面是一些非关键事务代码，例如下载一些图片文件，因
//此开启出错继续执行参数设置。

……
……
return0;
}

lr_convert_string_encoding

作用

将字符串转换为不同的编码

返回值

成功，0；
失败，-1；

参数

含有4个参数
sourceString：被转换的源字符串。
fromEncoding：转换前的字符编码。
toEncoding：要转换成为的字符编码。
paramName：转换后的目标字符串，即存放转换后的字符串。
Lr中相应参数对应的编码：
LR_ENC_SYSTEM_LOCALENULL
LR_ENC_UTF8"utf-8"
LR_ENC_UNICODE"ucs-2"

例子

Action()
{
intrc=0;
unsignedlongconverted_buffer_size_unicode=0;
char*converted_buffer_unicode=NULL;
rc=lr_convert_string_encoding("Helloworld",
LR_ENC_SYSTEM_LOCALE,
LR_ENC_UNICODE,
"stringInUnicode");
if(rc<0)
{
lr_output_message("字符编码转换失败");
}
return0;
}

lr_disable_ip_spoofing&lr_enable_ip_spoofing

作用

在运行脚本中开启和关闭IP欺骗

返回值

成功，0；
失败，-1；
例子：

参数

无

例子

lr_enable_ip_spoofing();
....
lr_disable_ip_spoofing();

lr_abort

作用

终止脚本的运行。

在9.5的帮助文档中是这样描述的:
如果终止了action里脚本的运行，将会直接运行vuser_end中的脚本。
当你用这个函数结束脚本的运行，它的状态将会是stop，这里应该指的是在controller中运
行后在analysis中的状态

我们使用该函数可以手动来终止脚本的运行，试了一下该函数得到以下结论：
如果在vuser_init中运行此函数，将会直接终止，不在运行之后的函数，包括aciton和vus
er_end;
如果有新建的action,在action中或新建的action中使用该函数，都将直接终止运行，直接
运行vuser_e