LR脚本函数基础

LR函数分类

1.VU通用函数，一般以lr开头

2.协议函数，一般以协议类型开关。如Web(HTTP/HTML)协议，web_url就是其一个协议函数

3.语言函数

 

全局变量与局部变量

globals.h文件中可定义全局变量

 

用户自定义函数

1.直接引用

2.本地加载

lr_load_dll("my.dll")

Myfunc();   //在my.dll定义该函数，在加载后可直接调用。

3.include 模式

在脚本里调用多个自定义函数，可以写在一个文件里，然后在init/action/end 中include之后就可以直接使用

4.全局加载模式

需要修改 /loadrunner/dat 目录下的相应文件

 

通用VU函数包括以下6种

1.事务和控制函数

• lr_end_sub_transaction 标记子事务的结束以便进行性能分析
• lr_end_transaction 标记LR事务的结束
• lr_end_transaction_instance 标记事务实例的结束以便进行性能分析
• lr_fail_trans_with_error 将打开事务的状态设置为LR_FAIL 并发送错误消息
• lr_get_trans_instance_duration 获取事务实例的持续时间（由它的句柄指定）
• lr_get_trans_instance_wasted_time 获取事务实例浪费的时间（由它的句柄指定）
• lr_get_transaction_duration 获取事务的持续时间（按事务的名称）
• lr_get_transaction_think_time 获取事务的思考时间（按事务的名称）
• lr_get_transaction_wasted_time 获取事务浪费的时间（按事务的名称）
• lr_resume_transaction 继续收集事务数据以便进行性能分析
• lr_resume_transaction_instance 继续收集事务实例数据以便进行性能分析
• lr_set_transaction_instance_status 设置事务实例的状态
• lr_set_transaction_status 设置打开事务的状态
• lr_set_transaction_status_by_name 通过事务名称设置其状态
• lr_start_sub_transaction 标记子事务的开始
• lr_start_transaction 标记事务的开始
• lr_start_transaction_instance 启动嵌套事务（由它的父事务的句柄指定）
• lr_stop_transaction 停止事务数据的收集
• lr_stop_transaction_instance 停止事务（由它的句柄指定）数据的收集
• lr_wasted_time 消除所有打开事务浪费的时间

2.命令行分析函数

• lr_get_attrib_double 检索脚本命令行中使用的double类型的变量
• lr_get_attrib_long 检索脚本命令行中使用的long类型的变量
• lr_get_attrib_sting 检索脚本命令行中使用的string类型的变量

3.系统信息函数

• lr_user_data_point 记录用户定义的数据采集点
• lr_whoami 将有关VUSER的信息返回给VUSER脚本
• lr_get_host_name 返回执行VUSER脚本的主机名
• lr_get_master_host_nme 返回运行LR Controller的计算机名

4.字符串函数

• lr_eval_string 返回参数的当前值
• lr_save_string 将以NULL结尾的字符串保存到参数中
• lr_save_var 将变长字符串保存到参数中
• lr_save_datetime 将当前日期和时间保存到参数中
• lr_advance_param 前进到下一个可用参数
• lr_decrypt 解密已编码的字符集
• lr_eval_string_ext     lr_eval_string的扩展，为指向包含参数数据的缓冲区的指针
• lr_eval_string_ext_free 释放由lr_eval_string_ext分配的指针
• lr_save_searched_string 在缓冲区中搜索字符串实例，并将该字符串实例保存到参数中

5.消息函数

• lr_debug_message 将调试消息发送到输出窗口
• lr_error_message 将错误消息发送到输出窗口
• lr_get_debug_message 得到当前的消息类
• lr_log_message 将输出消息直接发送到output.txt文件
• lr_output_message 将消息发送到输出窗口
• lr_set_debug_message 为输出消息设置消息类
• lr_vuser_status_message 生成格式化输出并将其打印到Controller Vuser状态区域
• lr_message 将消息发送到Vuser日志和输出窗口

6.运行时函数

• lr_load_dll 加载外部DLL
• lr_think_time 暂停脚本执行，以模拟思考时间
• lr_continue_on_error 指定脚本如何处理错误场景，是继续还是退出
• lr_rendezvous 在VUSER脚本中设置集合点

 

 --via<性能测试从零开始>