LoadRunner通用函数详解(中文)

脚本运行相关

lr_get_vuser_ip

作用

获取虚拟用户IP。

返回值

成功，返回虚拟用户的IP指针；

失败，返回NULL.

参数

无

例子

Action()

{

char *ip;

ip = lr_get_vuser_ip();

if (ip)

lr_output_message("The IP address is %s", ip);

else

lr_output_message("IP spoofing disabled");

}

lr_vuser_status_message

作用

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

成功，0；

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

参数

（格式化输出）

例子

lr_vuser_status_message( "We are on iteration #%s", lr_eval_string( "{iteration}" ) );

lr_continue_on_error

作用

指定错误处理的方法

返回值

无

参数

（int value）

0：取消出错继续执行设置

1：发生错误继续运行脚本

2：发生错误跳至下个Action运行

3：发生错误跳至下一迭代来运行

4：发生错误结束当前用户

例子

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

Action()

{

……

……

lr_continue_on_error (0); //下面是一些重要事务代码，因此关闭出错继续执行设置……

……

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

……

……

return 0;

}

lr_convert_string_encoding

作用

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

返回值

成功，0；

失败，-1；

参数

含有4个参数

sourceString：被转换的源字符串。

fromEncoding：转换前的字符编码。

toEncoding：要转换成为的字符编码。

paramName：转换后的目标字符串，即存放转换后的字符串。

例子

Action()

{

int rc = 0;

unsigned long converted_buffer_size_unicode = 0;

char *converted_buffer_unicode = NULL;

rc = lr_convert_string_encoding("Hello world",

LR_ENC_SYSTEM_LOCALE,

LR_ENC_UNICODE,

"stringInUnicode");

if(rc < 0)

{

lr_output_message("字符编码转换失败");

}

return 0;

}

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_end里的脚本。

返回值

无

参数

无

例子

int status;

status = web_url("Login",

"URL=https:////login.asp?user=(username)&session={ssid}",

"RecContentType=text/html", LAST);

if (status == LR_FAIL) {

lr_error_message("Error: %s", "Unable to login to secure computing");

lr_abort();

}

lr_decrypt

作用

解密字符串，该功能主要是对于脚本中出现的密码等不想外泄，现将密码使用lr加密，在脚本中使用该函数解密

返回值

成功，指向解码字符串

失败，NULL