转自(原基础上部分完善)：https://blog.csdn.net/u014283673/article/details/53321070
背景：运行loadrunner脚本生成器，新建脚本，按F1 查看帮助文档或参考其它文档，所整理的函数文档详解：
一、基础函数简介
在VU左边导航栏中，有三个LoadRunner框架函数，分别是vuser_init()、Action()、vuser_end()。这三个函数存在于任何Vuser类型的脚本中。
- vuser_init:虚拟用户的初始化函数，一般将用户初始化的操作放在这里，如登录操作、分配内存等。在做uvser_init的时候，Controller的Vuser状态区域会显示initialize状态(只运行一次)。
- Action:虚拟用户要做的业务，用户的业务操作，也就是测试内容的主体。在VU里设置迭代循环选项时，只针对Action有效，Action会被重复运行，而init和end部分则在脚本的运行过程中只会运行一次。
- vuser_end:与vuser_init相对应，uvser_end做收尾工作。在vuser_init中如果是登录，vuser_end里面就是退出登录；在vuser_init中如果是申请内存，比如使用了malloc函数，在vuser_end中应该就是释放内存，使用free函数。
在VU右侧脚本编辑框中，我们看到的是Action的实现主体，在运行时，Action内的web_url函数会被调用执行。
在LoadRunner的脚本中，我们可以调用三种函数：
- VU通用函数，一般以lr开头，就如上面的lr_start_transaction函数。
- 协议相关函数，不通类型的Vuser的函数一般以本协议类型开头。如果上面的脚本时Web(HTTP/HTML)类型的，web_url就是一个协议函数，web前缀说明它是属于Web HTTP协议的，HTTP协议函数还包括web_list、web_link。
- 语言相关函数。上面的VU脚本时用C语言写的，那么C语言的标准函数或dll都可以在这里被加载和使用。
二、通用VU函数
通用VU函数是构建在C语言基础之上的脚本框架函数，起支持作用。通用VU函数有一个特征，就是以LR开头，以标明它们属于LR，而不专属于任何协议，只要是C脚本，都可以使用。
通用VU函数可分为：
- 事务控制函数；
- 命令行分析函数；
- 系统信息函数；
- 字符串函数；
- 日志函数；
- 运行时函数；
1、事务与事务控制函数
软件系统的性能就是开一个个事务来度量的。LoadRunner中事务的定义就是靠事务函数来进行的，在执行性能测试时，LoadRunner会采集完成其定义的每个事务所花费的时间，并在性能测试后再Ayslysis中进行统计分析。
- lr_start_sub_transaction(子事务名，父事务名):标记子事务的开始。
- lr_end_sub_transaction:标记子事务的结束以便进行性能分析。
- int lr_end_sub_transaction（const char *sub_transaction，int status）;
- lr_start_transaction:标记事务的开始。
- lr_end_transaction:标记LoadRunner事务的结束。
- lr_start_transaction_instance:启动嵌套事务。
- lr_end_transaction_instance:标记事务实例的结束以便进行性能分析。
- lr_fail_trans_with_error:将打开事务的状态设置为LR_FAIL并发送错误消息。
- if(status != SUCCESS) lr_fail_trans_with_error("an error has occurred:%s",my_get_error_string(status)); lr_end_transaction("登陆成功",LR_AUTO);
- lr_get_trans_instance_duration:获取事务实例的持续时间。
- trans_time=lr_get_transaction_wasted_time("访问注册页"); //获得消耗时间
if (trans_time) {
lr_output_message("The duration up to the submit is %f seconds",trans_time); //打印数输出消耗实时间
}else{
lr_output_message("the duration cannot be determined. ");
}
lr_end_transaction("访问注册页",LR_AUTO); //事务结束
- lr_get_trans_instance_wasted_time:获取事务实例浪费的时间。
- lr_get_transaction_status：用于获取事务的状态
- if (lr_get_transaction_status() == LR_FAIL)
{
//由于web_url请求失败了，所以没有必要继续执行下去，因些设置事务状态为FAIL
lr_end_transaction("登陆失败",LR_FAIL);
return;
}
- lr_resume_transaction:继续收集事务数据以便进行性能分析。
- lr_resume_transaction_instance:继续收集事务实例数据以便进行性能分析。
- lr_set_transaction_instance_status:设置事务实例的状态。
- if(event == GENERAL_ERROR) lr_set_transaction_instance_status(LR_FAIL); lr_end_transaction("登陆",LR_AUTO);
- lr_set_transaction_status:设置打开事务的状态。
- lr_set_transaction_status_by_name:设置事务的状态。
- lr_stop_transaction:停止事务数据的收集。
- lr_stop_transaction_instance:停止事务数据的收集。
- lr_wasted_time:消除所有打开事务浪费的时间。
2、命令行分析函数
当LoadRunner用命令行方式启动和运行时，以下函数用来分析命令行，以得到命令行中的参数信息。
- lr_get_attrib_double:检索脚本命令行中使用的double类型变量。
- lr_get_attrib_long:检索脚本命令行中使用的long类型变量。
- lr_get_attrib_string:检索脚本命令行中使用的字符串。
3、系统信息函数
用来得到VU系统信息：
- lr_user_data_point:记录用户定义的数据采集点。
- lr_whoami:将有关Vuser的信息返回给Vuser脚本。
- lr_get_host_name:返回执行Vuser脚本的主机名。
- lr_get_master_host_name:返回运行LoadRunner Controller的计算机名。
4、字符串函数
主要是对参数进行操作，包括对不通类型参数的读取、存储和移动。
- lr_eval_string:返回参数的当前值。
- lr_save_string("value","param"):将以NULL结尾的字符串保存到参数中。
- lr_save_var:将变长字符串保存到参数中。
- lr_save_datetime:将当前日期和时间保存到参数中。
- lr_advance_param:前进到下一个可用参数。
- lr_paramarr_random("randomParam"):随机输出值
- lr_decrypt:解密已编码的字符串。
- lr_eval_string_ext:lr_eval_string的扩展，为指向包含参数数据的缓冲区的指针。
- lr_eval_string_ext_free:释放由lr_eval_string_ext分配的指针。
- lv_save_searched_string:在缓冲区中搜索字符串实例，并将改字符串实例保存到参数中。
- lr_convert_string_encoding("被转换前",LR_ENC_SYSTEM_LOCALE,LR_ENC_UTF8,"转换后的字符串");
- web_convert_param("需要转url二进制的字符串", "SourceEncoding=PLAIN", "TargetEncoding=URL", LAST );
5、消息函数
是VU发送和记录log的函数
- lr_debug_message:将调试消息发送到输出窗口。
- lr_error_message:将错误消息发送到输出窗口。
- lr_get_debug_message:得到当前的消息类。
- lr_log_message:将输出消息直接发送到output.txt文件，此文件位于Vuser脚本目录中。
- lr_output_message:将消息发送到输出窗口。
- lr_set_debug_message:为输出消息设置消息类。
- lr_vuser_status_message:生成格式化输出并将其打印到Controller Vuser状态区域。
- lr_message:将消息发送到Vuser日志和输出窗口。
6、运行时函数
运行时(run-time)多数是通过VU的runtime来设置的。
- lr_load_dll,加载外部dll。
- lr_think_time:暂停脚本的执行，以模拟思考时间。
- lr_continue_on_error,指定脚本如何处理错误场景，是继续还是退出。
- lr_rendezvous:在Vuser脚本中设置集合点。
7、检查点函数
- web_find()函数： 在页面中查找相应内容
- web_reg_find()函数： 在缓存中查找相应的内容
- web_image_check()函数：在页面中查找具体图片。
他们的具体用法，你们可以在脚本的编写中，光标定位在函数中，按F1 查看帮助文档或参考其它文档。
三、协议相关函数
除了通用Vuser函数以外，Vugen还会在录制时生成特定于协议的函数，并将它们插入到Vuser脚本中。
1、Http协议
Header设置函数：
- Web_add_header
- web_add_auto_header
- Web_clean_header
- web_revert_auto_header函数等同于具有ImplicitGen选项设置为Yes的web_remove_auto_header函数。
点击链接:
- Web_link
- Web_image
提交表单:
- Web_submit_data
- Web_submit_form
2、Web系统设置
Cache设置:
- Web_cache_leanup
- Web_load_cache
Cookie设置:
- Web_add_cookie
- Web_cleanup_cookies
Proxy设置:
- Web_set_proxy
- Web_set_secure_proxy
3、LoadRunner框架支持
检查点：设置需要启用检查点
- Web_find 请求方法之后
- web_reg_find 请求方法之前
- Web_image_check
关联：
- Web_create_html_param
- Web_create_html_param_ex
- Web_reg_save_param
- Web_set_max_html_param_len
控制：
- Lr_start_transaction/lr_end_transaction
- Lr_start_sub_transaction / Lr_end_sub_transaction
- Lr_rendzvous
- Lr_think_time