loadrunner常用的函数

一：通用函数

LoadRunner的通用函数以lr为前缀，可以在任何协议中使用。可以如下分类：

信息相关的函数：

lr_error_message lr_output_message

事务函数：

lr_start_transaction  lr_end_transaction

运行时函数：

lr_think_time       lr_exit

参数相关的函数：

lr_save_datetime lr_advance_param lr_eval_stringlr_save_string lr_get_attrib_string

一些函数的详细解释：

1．lr_error_message

往VuGen的回放日志和Controller的输出窗口发送错误信息，例子：

lr_error_message("string");

2．lr_abort()

中止脚本的执行。如果在Action中使用，就会中止Action的执行，而去执行vuser_end.

3．lr_exit

退出脚本，action或者迭代。

lr_exit(intcontinuation_option, intexit_status);

4．lr_save_string

保存指定的非空字符串到一个参数。

lr_save_string(const char *param_value, const char*param_name);

5．lr_save_date_time

保存日期和时间到参数中。

lr_save_datetime(const char *format,intoffset,const char*name);

在lr_save_datetime中使用偏移量

lr_save_datetime(“Tomorrow is %B %d %Y", DATE_NOW+ONE_DAY,“nextDate");

DATE_NOW+ONE_DAY：当前日期的偏移量

如果现在的时间是：2008年二月27

nextDate中保存的时间为：Tomorrow is二月28 2008

6．lr_advance_param

lr_advance_param (const char *param);

其中参数用双引号，但不用括号。

7．lr_eval_string

lr_eval_string("{parameter_name}");

返回指定参数的当前字符串值。

检索参数值，可以使用来下面的函数打印该输出到输出信息中。

lr_output_message或者lr_error_message

8．lr_get_attrib_string

lr_get_attrib_string (const char *argument);

二．特定协议的函数

这类函数跟录制的协议类型有关系。

Web协议：以web为前缀

lrd是数据库相关的函数，lrs是window socket协议的函数。

web_reg_save_param(const char*ParamName,LB,RB,ORD,SaveLen,SaveOffset, LAST);

例子：

web_reg_save_param("flight_name", "LB=Select your departure ","RB="", LAST);

web_reg_find:

web_reg_find(“Text=Welcome”, SaveCount, LAST);

loadrunner常用的函数如下：

lr_start_transaction 为性能分析标记事务的开始 

lr_end_transaction 为性能分析标记事务的结束 

lr_rendezvous 在 Vuser 脚本中设置集合点 

lr_think_time 暂停 Vuser 脚本中命令之间的执行 

lr_end_sub_transaction标记子事务的结束以便进行性能分析 

lr_end_transaction 标记 LoadRunner 事务的结束 

Lr_end_transaction("trans1",Lr_auto); 

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("trans1"); 

lr_start_transaction_instance启动嵌套事务（由它的父事务的句柄指定） 

lr_stop_transaction 停止事务数据的收集 

lr_stop_transaction_instance停止事务（由它的句柄指定）数据的收集 

lr_wasted_time 消除所有打开事务浪费的时间 

lr_get_attrib_double 检索脚本命令行中使用的 double类型变量 

lr_get_attrib_long 检索脚本命令行中使用的 long类型变量 

lr_get_attrib_string 检索脚本命令行中使用的字符串 

lr_user_data_point 记录用户定义的数据示例 

lr_whoami 将有关 Vuser 脚本的信息返回给 Vuser 脚本 

lr_get_host_name 返回执行 Vuser 脚本的主机名 

lr_get_master_host_name 返回运行 LoadRunner Controller的计算机名 

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_ext_free 释放由 lr_eval_string_ext分配的指针 

lr_save_searched_string在缓冲区中搜索字符串实例，并相对于该字符串实例，将该缓冲区的一部分保存到参数中 

lr_debug_message 将调试信息发送到输出窗口 

lr_error_message 将错误消息发送到输出窗口 

lr_get_debug_message 检索当前消息类 

lr_log_message 将消息发送到日志文件 

lr_output_message 将消息发送到输出窗口 

lr_set_debug_message 设置调试消息类 

lr_vuser_status_message 生成带格式的输出，并将其写到 ControllerVuser状态区域 

lr_message 将消息发送到 Vuser 日志和输出窗口 

lr_load_dll 加载外部 DLL 

lr_peek_events 指明可以暂停 Vuser 脚本执行的位置 

lr_think_time暂停脚本的执行，以模拟思考时间（实际用户在操作之间暂停以进行思考的时间） 

lr_continue_on_error 指定处理错误的方法 

lr_continue_on_error (0）；lr_continue_on_error（1）； 

lr_rendezvous 在 Vuser 脚本中设置集合点 

TE_wait_cursor 等待光标出现在终端窗口的指定位置 

TE_wait_silent 等待客户端应用程序在指定秒数内处于静默状态 

TE_wait_sync 等待系统从 X-SYSTEM 或输入禁止模式返回 

TE_wait_text 等待字符串出现在指定位置 

TE_wait_sync_transaction 记录系统在最近的 X SYSTEM模式下保持的时间 

WEB函数列表： 

web_custom_request 允许您使用 HTTP 支持的任何方法来创建自定义 HTTP请求 

web_image 在定义的图像上模拟鼠标单击 

web_link 在定义的文本链接上模拟鼠标单击 

web_submit_data 执行“无条件”或“无上下文”的表单 

web_submit_form 模拟表单的提交 

web_url 加载由“URL”属性指定的 URL 

web_set_certificate 使 Vuser 使用在 Internet Explorer注册表中列出的特定证书 

web_set_certificate_ex指定证书和密钥文件的位置和格式信息 

web_set_user 指定 Web 服务器的登录字符串和密码，用于 Web服务器上已验证用户身份的区域 

web_cache_cleanup 清除缓存模拟程序的内容 

web_find 在 HTML 页内搜索指定的文本字符串 

web_global_verification 在所有后面的 HTTP请求中搜索文本字符串 

web_image_check 验证指定的图像是否存在于 HTML页内 

web_reg_find 在后面的 HTTP 请求中注册对HTML源或原始缓冲区中文本字符串的搜索 

web_disable_keep_alive 禁用 Keep-Alive HTTP连接 

web_enable_keep_alive 启用 Keep-Alive HTTP连接 

web_set_connections_limit 设置 Vuser在运行脚本时可以同时打开连接的最大数目 

web_concurrent_end 标记并发组的结束 

web_concurrent_start 标记并发组的开始 

web_add_cookie 添加新的 Cookie 或修改现有的Cookie 

web_cleanup_cookies 删除当前由 Vuser 存储的所有Cookie 

web_remove_cookie 删除指定的 Cookie 

web_create_html_param 将 HTML 页上的动态信息保存到参数中。（LR 6.5及更低版本） 

web_create_html_param_ex 基于包含在 HTML 页内的动态信息创建参数（使用嵌入边界）（LR 6.5及更低版本）。 

web_reg_save_param 基于包含在 HTML页内的动态信息创建参数（不使用嵌入边界） 

web_set_max_html_param_len 设置已检索的动态 HTML信息的最大长度 

web_add_filter 设置在下载时包括或排除 URL 的条件 

web_add_auto_filter 设置在下载时包括或排除 URL的条件 

web_remove_auto_filter 禁用对下载内容的筛选 

web_add_auto_header 向所有后面的 HTTP请求中添加自定义标头 

web_add_header 向下一个 HTTP 请求中添加自定义标头 

web_cleanup_auto_headers 停止向后面的 HTTP请求中添加自定义标头 

web_remove_auto_header 停止向后面的 HTTP请求中添加特定的标头 

web_revert_auto_header 停止向后面的 HTTP请求中添加特定的标头，但是生成隐性标头 

web_save_header 将请求和响应标头保存到变量中 

web_set_proxy 指定将所有后面的 HTTP请求定向到指定的代理服务器 

web_set_proxy_bypass 指定 Vuser直接访问（即不通过指定的代理服务器访问）的服务器列表 

web_set_proxy_bypass_local 指定 Vuser 对于本地 (Intranet)地址是否应该避开代理服务器 

web_set_secure_proxy 指定将所有后面的 HTTP请求定向到服务器 

web_set_max_retries 设置操作步骤的最大重试次数 

web_set_timeout 指定 Vuser 等待执行指定任务的最长时间 

web_convert_param 将 HTML 参数转换成 URL或纯文本 

web_get_int_property 返回有关上一个 HTTP请求的特定信息 

web_report_data_point 指定数据点并将其添加到测试结果中 

web_set_option 在非 HTML 资源的编码、重定向和下载区域中设置 Web选项 

web_set_sockets_option 设置套接字的选项 

#include "web_api.h"

Action()

{

    char*abort="aborting...";

    char *my_host; 

    char*ip; 

    ip =lr_get_vuser_ip(); 

    if(ip) 

    lr_output_message("TheIP address is %s", ip); 

   else 

    lr_output_message("IPspoofing disabled"); 

    lr_message ("loginfailed: %s", abort);

   lr_save_datetime("Tomorrow is %B %d %Y", DATE_NOW +ONE_DAY,"next"); 

   lr_output_message(lr_eval_string("{next}")); 

    my_host =lr_get_host_name( ); 

   lr_output_message("您的机器名称：%s", my_host);