loadrunner常用函数.docx

1、loadrunner常用函数Loadrunner常用函数1字符串及数据转换操作函数1.1常用函数A.函数介绍 Strlen(const char *string) strcpy(destination_string, source_string); /拷贝一个字符串到另一个字符串中. strcat(string_that_gets_appended, string_that_is_appended);/合并字符串 atoi(string_to_convert_to_int); /returns the integer value 字符串转换为整型 itoa(integer_to_conver_

2、to_string, destination_string, base); 整型转换为字符串 strcmp(string1, string2); /比较字符串 0：相同 stricmp(string1,string2) /区分大小写比较字符串 strstr(string1,string2) / strlwr(const char *string) /将字符串转换为小写 strupr(const char *string) /将字符串转换为大写B.实用例子/常用字符串处理函数的例子 Actions() char MyString120 = ; char MyString220 = ; char

3、MyString320 = Mercury2; char Cstring10 = 12345; int Cint; strcpy(MyString1,Mercury1); / Now MyString1 contains Mercury1 / Copy MyString3 into MyString2 strcpy(MyString2,MyString3); / Catenate MyString2 to MyString1 strcat(MyString1,MyString2); / Cstring is converted to integer Cint Cint = atoi(Cstri

4、ng); / Cint is converted to string Cint = 100; itoa(Cint,Cstring,10); return 0; /字符串查找和截取例子 /* 声明：int findSubStr(char* resultStr,char* sourceStr,char* beginStr,char* endStr) 功能：将字符串sourceStr中beginStr和endStr之间的字符串输出给resultStr 返回值：0：成功 1：失败 调用方法：findSubStr(resultStr,”my name is zhangwei too”,”is”,”too

5、”)*/int findSubStr(char* resultStr,char* sourceStr,char* beginStr,char* endStr) int ilen,i; char* findStartPos; char* findEndPos; findStartPos = (char*)strstr(sourceStr,beginStr); if (findStartPos=NULL) return -1; lr_output_message(findStartPos=%s,findStartPos); findEndPos = (char*)strstr(findStartP

6、os,endStr); if (findEndPos=NULL) return -1; lr_output_message(findEndPos=%s,findEndPos); ilen=strlen(beginStr); findStartPos=findStartPos+ilen; lr_output_message(findStartPos=%s,findStartPos); ilen=findEndPos-findStartPos; strncpy(resultStr,findStartPos,ilen); lr_output_message(resultstr=%s,resultSt

7、r); return 0;1.2格式化字符串A.函数介绍 函数定义：int sprintf(char *string, char *farmat ,argument,.) 对于format说明： %s：格式化字符串 %d：格式化数字类型为字符串 %x：将数字格式化成小写十六进制数的字符串 %X：将数字格式化成小写十六进制数的字符串 格式化结果长度：%5d(5位),%8x（8位） %-4d、%-5x、%-6X：格式化结果左对齐，（没有-表示是右对齐） sprintf(s, %d, 123); /将数字123格式化成123 sprintf(s, %5d%5d, 123, 4567); /指定格式化

8、长度，结果是：s= 123 4567 sprintf(s, %-5x%5d, 123, 4567); /指定格式化长度，结果是：s=7b 4567B.实用例子Action() int i,k; float j; char formatStr32; i=123; k=-123; j=123.456; sprintf(formatStr,formatStr=%s,format example); lr_output_message(formatStr); sprintf(formatStr,format integer(123)=%d,i); lr_output_message(formatStr

9、); sprintf(formatStr,format float(123.456)=%3.1f,j); lr_output_message(formatStr); sprintf(formatStr,format hex(123)=%x,i); lr_output_message(formatStr); sprintf(formatStr,format HEX(123)=%X,i); lr_output_message(formatStr); sprintf(formatStr,format integer(-123)=%5d%5X,i,i); lr_output_message(forma

10、tStr); return 0;运行结果：Action.c(10): formatStr=format exampleAction.c(12): format integer(123)=123Action.c(14): format float(123.456)=123.5Action.c(16): format hex(123)=7bAction.c(18): format HEX(123)=7BAction.c(20): format integer(-123)= 123 7B1.3数据类型转换函数A.函数介绍Sprintf：可以将其它数据类型转换为字符串类型（1.2中有详细描述）Atoi

11、:将字符转换为整数类型Itoa:将整数转换为字符存储到第二个参数中，可以将整数转换为不同的数据类型字符串Atof：将字符转换为浮点类型（使用时应该首先在文件头声明double atof(const char *string);），否则结果是错误的Atol：将字符转换为长整数类型Strtol：将一个字符串中的第一个数字字符串部分转换成长整数类型B.例子 以下脚本是数据类型转换的例子double atof(const char *string); /必须加上这一行，否则atof函数会出现错误结果Action() int i; double j; long k; char ichange32; /*

12、 itoa 函数例子 */ i=123; itoa(i,ichange,10); /将整数转换为十进制的字符串 lr_output_message(ichange=%s,ichange); itoa(i,ichange,16); /将整数转换为十六进制的字符串 lr_output_message(ichange=%s,ichange); itoa(i,ichange,2); /将整数转换为二进制的字符串 lr_output_message(ichange=%s,ichange); /* atoi 函数例子 */ i=atoi(12345); /将字符串转换为整数 lr_output_messa

13、ge(atoi(12345)=%d,i); /* atof 函数例子 */ j=atof(123.12); /将字符串转换为浮点数 lr_output_message(atof(123.12)=%.3f,j); /* atol 函数例子 */ k=atol(1234567890); /将字符串转换为长整型 lr_output_message(atol(1234567890)=%d,k); /* strtol 函数例子 */ /strcpy(ichange,1234567890 is long int); k=strtol(1234M567890,ichange,10); /将字符串转换为长整型

14、 lr_output_message(strtol()=%d,k); return 0;运行结果： Action.c(13): ichange=123 Action.c(15): ichange=7b Action.c(17): ichange=1111011 Action.c(21): atoi(12345)=12345 Action.c(25): atof(123.12)=123.120 Action.c(29): atol(1234567890)=1234567890 Action.c(34): strtol()=12341.4字符串编码转换的函数 函数定义：nt lr_convert_

15、string_encoding ( const char *sourceString, const char *fromEncoding, const char *toEncoding, const char *paramName); 该函数有4个参数，含义如下： sourceString：被转换的源字符串。 fromEncoding：转换前的字符编码。 toEncoding：要转换成为的字符编码。. paramName：转换后的目标字符串。 例子：我们需要把字符（“汽车”）编码转换为UTF-8格式，因此用法如下： lr_convert_string_encoding(汽车,LR_ENC_SY

16、STEM_LOCALE,LR_ENC_UTF8,str);2日期时间相关函数2.1函数介绍lr_save_datetime void lr_save_datetime(const char *format, int offset, const char *name); 中文解释： lr_save_datetime将当前日期和时间，或具有指定偏移的日期和时间保存在参数中。如果达到MAX_DATETIME_LEN个字符，结果字符串将被截断。参数说明： const char *format 格式化信息，如：%Y-%m-%d代表日期格式，%H:%M:%S代表时间格式int offset： 时间的偏移量

17、 DATE_NOW(现在的日期) TIME_NOW(现在的时间) ONE_DAY(一天的时间) ONE_HOUR(一小时的时间) ONE_MIN(一分钟的时间) 需要注意的是，时间的偏移量可以使用公式，例如：DATE_NOW+ONE_DAY 这样，我们就可以取得昨天、明天的日期了 DATE_NOW-ONE_DAY(昨天) DATE_NOW+ONE_DAY(明天)const char *name 参数保存的参数名；使用lr_eval_string(参数名)可以获取参数值 time 返回1970-1-1至现在的时间差（秒）2.2例子 取得当前日期时间 lr_save_datetime(%Y-%m-

18、%d %H:%M:%S,DATE_NOW,abc); lr_output_message(now=%s,lr_eval_string(abc); 运行结果：now=2010-10-12 16:52:35 取得前天的日期 lr_save_datetime(%Y-%m-%d,DATE_NOW-2*(ONE_DAY),abc); lr_output_message(前天=%s,lr_eval_string(abc); 运行结果：前天=2010-10-10 取得2个小时后的时间 lr_save_datetime(%H:%M:%S,TIME_NOW+2*(ONE_HOUR),abc); lr_outpu

19、t_message(2小时后=%s,lr_eval_string(abc); 运行结果：2小时后=18:56:05 取得当前的时间，精确到毫秒 在Vgen中添加参数，参数属性设置为datet/ime，属性中格式输入%Y-%m-%d %H:%M:%S.000，参数值即为当前时间（精确到毫秒），如下图所示 3XML相关函数Lr提供的XML操作函数仅适用于WEB/HTTP，webservice协议；3.1读取XML文件内容函数 Lr_xml_extract:获取一个字段区间的字符串 Lr_xml_find:查询XML字符串的数量 Lr_xml_get_values:查找XML字段元素的值例子： #i

20、nclude as_web.h Action() int findflag; char * xml_input = zhengzhou ; /查找字段city中的全部内容 lr_save_string(xml_input, XML_Param); lr_xml_extract(XML=XML_Param,XMLFragmentParam=Querycity); lr_output_message(lr_eval_string(查询结果: Querycity); /查找name=zhengzhou的个数 findflag=lr_xml_find(XML=XML_Param,value=zheng

21、zhou, Query=/vcom/area/city/name, LAST); lr_output_message(找到 %d 处zhengzhou,findflag); /获取name字段的值 lr_xml_get_values(XML=XML_Param,ValueParam=Querycity, Query=/vcom/area/city/name, LAST); lr_output_message(lr_eval_string(查询字段值结果: Querycity); return 0; 运行结果： Action.c(11): lr_xml_extract succeeded, 1

22、match processed Action.c(13): 查询结果: zhengzhou Action.c(15): lr_xml_find succeeded, 1 match processed Action.c(16): 找到 1 处zhengzhou Action.c(18): lr_xml_get_values succeeded, 1 match processed Action.c(20): 查询字段值结果: zhengzhou3.2写XML操作函数 lr_xml_delete: 按区间删除 XML 中的字符串。 lr_xml_insert: 将新 XML 字段插入到 XML

23、字符串中。 lr_xml_replace: 替换 XML 字符串的字段和值。 lr_xml_set_values: 设置查询到的 XML 元素的值。 例子： Action() int findflag; char * xml_input = zhengzhou; lr_save_string(xml_input, XML_Param); /删除area区间的数据 lr_xml_delete(XML=XML_Param,ResultParam=Querycity, Query=/vcom/area, LAST); lr_output_message(lr_eval_string(删除后的结果:

24、Querycity); /将name字段值更改为zzcity lr_xml_replace(XML=XML_Param,ResultParam=Querycity, Query=/vcom/area/name,XmlFragment=zzcity,LAST); lr_output_message(lr_eval_string(更改后的结果: Querycity); /添加code字段内容 lr_xml_insert(XML=XML_Param,ResultParam=Querycity, XmlFragment=410100,Query=/vcom/area, LAST); lr_output

25、_message(lr_eval_string(添加后的结果: Querycity); /将name字段值改为zz_01 lr_save_string(zz_01, ReplaceValue); lr_xml_set_values(XML=XML_Param,ResultParam=ReplaceParam, ValueParam=ReplaceValue, Query=/name, LAST); lr_output_message(lr_eval_string(更改字段值的结果: ReplaceParam); return 0; 运行结果： Action.c(9): lr_xml_delet

26、e succeeded, 1 match processed Action.c(11): 删除后的结果: Action.c(14): lr_xml_replace succeeded, 1 match processed Action.c(16): 更改后的结果: zzcity Action.c(19): lr_xml_insert succeeded, 1 match processed Action.c(21): 添加后的结果: zhengzhou410100 Action.c(25): lr_xml_set_values succeeded, 1 match processed Acti

27、on.c(27): 更改字段值的结果: zz_014事务相关函数 lr_end_sub_transaction/标记子事务的结束以便进行性能分析 lr_end_transaction/标记LoadRunner事务的结束 lr_end_transaction_instance/标记事务实例的结束以便进行性能分析 lr_fail_trans_with_error/将打开事务的状态设置为LR_FAIL并发送错误消息 lr_get_trans_instance_duration/获取事务实例的持续时间（由它的句柄指定） lr_get_trans_instance_wasted_time/获取事务实例浪

28、费的时间（由它的句柄指定） 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_