Loadrunner常用函数列表

LoadRunner常用函数列表

Web相关函数

函 数	功  能  描  述
web_custom_request	用户可以通过该函数自行创建一个HTTP请求的函数
web_image	模拟用户单击图片操作的函数
web_link	模拟用户单击指定属性链接操作的函数
web_submit_data	执行“无状态“或“内容无关”提交数据操作的函数
web_submit_form	模拟表单数据提交操作函数
web_url	模拟访问一个指定网址资源的函数
web_find	在HTML页面查找指定的文本字符串的函数
web_global_verification	查找指定的文本在所有后续请求的函数
web_image_check	检查在HTML页面中是否存在指定的图片的函数
web_reg_add_cookie	注册一个指定的文本字符串，如果查找到文本将存储到Cookie中的函数
web_reg_find	注册一个在下一个动作查找指定字符串的函数
web_create_html_param	将指定动态数据存储在指定参数的函数
web_create_html_param_ex	将指定动态数据存储在指定参数的扩展的函数
web_reg_save_param	存储非空结束动态数据到指定参数的函数
web_save_param_length	存储参数的长度的函数
web_save_timestamp_param	存储时间戳的函数
web_set_max_html_param_len	设定指定参数获得最大动态数据长度的函数
web_set_proxy	设置代理发送可靠HTTP请求的函数
web_set_proxy_bypass	指定一个URL列表，允许虚拟用户直接访问，不需要通过指定代理服务器的函数
web_set_proxy_bypass_local	指定是否通过本地代理地址访问的函数
web_set_secure_proxy	通过指定可靠安全的代理服务器发送HTTP安全请求的函数

FTP相关函数

函 数	功  能  描  述
ftp_delete	从指定FTP服务器删除指定文件的函数
ftp_dir	列出FTP服务器上的文件及其目录的函数
ftp_get	从FTP服务器上下载指定的文件的函数
ftp_get_last_download_details	断点续传指定文件的函数
ftp_get_last_error	从FTP服务器上获得最后一次错误信息的函数
ftp_get_last_error_id	从FTP服务器上获得最后一次错误信息ID的函数
ftp_get_last_handshake_duration	返回最近建立连接的连接持续时间的函数
ftp_get_last_transfer_duration	返回网络文件传输时间的函数
ftp_logon	登录FTP服务器的函数
ftp_logout	退出FTP服务器的函数
ftp_mkdir	在FTP服务器上建立一个目录的函数
ftp_put	上传一个文件到FTP服务器的函数
ftp_rendir	对FTP服务器上的文件夹重新命名的函数
ftp_rmdir	从FTP服务器上删除指定文件夹的函数

SMTP相关函数

函 数	功  能  描  述
smtp_abort_mail	取消邮件发送的函数
smtp_free	通过应用该函数释放SMTP服务器
smtp_logon	登录到SMTP服务器的函数
smtp_logout	退出SMTP服务器的函数
smtp_send_mail	发送SMTP消息的函数
smtp_translate	传输SMTP消息的函数

POP3相关函数

函 数	功  能  描  述
pop3_command	向POP3服务器发送一条指定指令的函数
pop3_delete	在POP3服务器上删除一条消息的函数
pop3_free	通过应用该函数释放POP3服务器
pop3_list	列出POP3服务器上所有消息的函数
pop3_logoff	退出POP3服务器的函数
pop3_logon	登录到POP3服务器的函数
pop3_retrieve	从POP3服务器上获得一条消息的函数

 日志相关函数

函 数	功  能  描  述
lr_debug_message	输出一条调试信息的函数
lr_error_message	发送一条错误信息到输出窗口的函数
lr_get_debug_message	返回当前日志设置信息的函数
lr_log_message	发送一条消息到Vuser日志文件的函数
lr_message	发送一条消息到Vuser日志并输出到窗口的函数
lr_output_message	将输出消息直接发送到output.txt文件，此文件位于Vuser脚本目录中。该函数有助于防止输出消息干扰TCP/IP通信的函数
lr_set_debug_message	设置输出消息类别的函数
lr_vuser_status_message	发送一条虚拟用户状态消息到Controller的函数

 字符串相关函数

函 数	功  能  描  述
lr_advance_param	参数化数据文件将指针移动到下一条记录的函数
lr_convert_string_encoding	转换一个字符串为别的编码格式的函数
lr_decrypt	将字符串转换为其他格式的编码的函数
lr_eval_string	返回参数的实际内容字符串的函数
lr_eval_string_ext	检索指向包含参数数据的缓冲区的指针的函数
lr_eval_string_ext_free	释放由  lr_eval_string_ext 分配的指针的函数
lr_param_increment	增加数值型变量值的函数
lr_save_datetime	保存日期时间到变量的函数
lr_save_searched_string	在缓冲区中搜索字符串实例，并相对于该字符串实例，将该缓冲区的一部分保存到参数中的函数
lr_save_string	将以NULL结尾的字符串保存到参数中的函数
lr_save_var	将变长字符串保存到参数中的函数

 命令行分析函数

函 数	功  能  描  述
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的计算机名的函数

 输入输出函数

函 数	功  能  描  述
fclose	关闭文件的函数
feof	检查是否当前位置为流文件末尾的函数
ferror	检查在输入/输出操作过程中是否有错误发生的函数
fgetc	从流文件读取一个字符的函数
fgets	从文件读取一个字符串的函数
fopen	打开一个文件的函数
fprintf	写入指定格式化的数据到一个文件的函数
fputc	写入一个字符到一个流文件的函数
fread	从流中读取非格式化数据到缓冲区的函数
fscanf	从流中读取格式化输入的函数
fseek	设置一个新位置作为当前位置的函数
fwrite	将缓冲区非格式化数据写到流中的函数
rewind	使文件的位置指针重新返回文件的开头的函数
sprintf	将一个格式化的字符串输出到一个目的字符串中的函数
sscanf	sscanf与scanf类似，都是用于输入的

内存相关函数

功  能  名  称	功  能  描  述
calloc	分配并初始化数组所有元素为0的函数
free	释放一块内存的函数
malloc	分配一块内存的函数
realloc	调整内存块大小的函数

 数值相关函数

功  能  名  称	功  能  描  述
atof	将字符串函数转换为浮点型数值的函数
atoi	将字符串转换为整型数值的函数
atoi	将指定字符串转换成为长整型数值的函数
itoa	将整型数值转换为字符串的函数（仅适用于Windows系统）
strtol	将字符串转换为长整型数值的函数

 文件相关函数

功  能  名  称	功  能  描  述
chdir	改变目录的函数
chdrive	改变指定的驱动器的函数，如从c:\改变到d:\
getcwd	返回当前工作目录的函数
getdrive	返回当前驱动器名称的函数
mkdir	创建指定名称的目录的函数
remove	删除指定的文件的函数
rmdir	删除指定目录的函数

 事务相关函数

函 数	功  能  描  述
lr_end_sub_transaction	标记子事务结束的函数
Lr_end_transaction	标记事务结束的函数
Lr_end_transaction_instance	标记事务实例结束的函数
Lr_fail_trans_with_error	将打开事务的状态设置为失败的函数
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	消除所有打开事务浪费时间的函数