03-CAPL 常用函数大全

专栏《CAPL 脚本编写实战指南》第 3 篇作者一线汽车电子测试工程师适合人群已掌握 CAPL 基础的测试人员、想系统学习 CAPL 函数的工程师开篇为什么要学 CAPL 函数这是我刚学 CAPL 时的真实经历。当时的情况基础语法学会了但写脚本时不知道用什么函数每次都要查 Help 文档效率很低后来我做了个函数速查表把常用函数分类整理每个函数配上示例代码打印出来贴在电脑旁写脚本时随时查阅效果写脚本效率提升 50%不用每次都查文档3 个月后常用函数都记住了这篇教程就是我把当年的速查表整理出来的。建议收藏这篇写脚本时随时查阅。一、输出函数1.1 write()功能格式化输出到 Write 窗口语法write(format, arg1, arg2, ...);示例// 输出字符串 write(Hello CAPL); // 输出整数 int value 100; write(value %d, value); // 输出多个值 int a 10, b 20; write(a %d, b %d, a, b); // 输出十六进制 byte data 0xFF; write(data 0x%x, data); // 输出浮点数 float pi 3.14159; write(pi %f, pi); // 换行输出 write(第一行); write(第二行);格式说明符说明符类型示例%d十进制整数write(%d, 100)→ “100”%x十六进制整数write(%x, 255)→ “ff”%f浮点数write(%f, 3.14)→ “3.140000”%s字符串write(%s, Hello)→ “Hello”%c字符write(%c, A)→ “A”%ld长整数write(%ld, 1000000L)注意write() 不会自动换行需要换行时加\nwrite(line1\nline2)或用多个 write()write(line1); write(line2);1.2 writeHex()功能以十六进制格式输出数据语法writeHex(format, value);示例// 输出十六进制 int value 255; writeHex(value %x, value); // value ff // 输出报文数据 on message msg_Test { writeHex(报文数据%x %x %x, this.byte(0), this.byte(1), this.byte(2)); }1.3 output()功能发送 CAN 报文语法output(message);示例variables { message CANMessage msg_Test; } on start { msg_Test.canID 0x123; msg_Test.dlc 8; msg_Test.byte(0) 0x10; output(msg_Test); // 发送报文 write(报文已发送); }扩展用法// 周期发送 outputPeriod(msg_Test, 100); // 100ms 周期发送 // 停止发送 outputStop(msg_Test);二、时间函数2.1 timeNow()功能获取当前时间毫秒语法long time timeNow();示例on start { long startTime timeNow(); write(程序启动时间%d ms, startTime); } on message msg_Test { long recvTime timeNow(); write(收到报文时间%d ms, recvTime); }应用场景计算执行时间记录事件时间戳超时检测2.2 time()功能等待指定时间不阻塞语法time(milliseconds);示例on start { write(开始等待); time(1000); // 等待 1 秒 write(等待结束); }注意time() 是不阻塞的实际等待时间可能略长于指定时间精确延时用定时器2.3 testWaitForTimeout()功能测试等待阻塞语法testWaitForTimeout(milliseconds);示例on test { // 发送请求 sendRequest(); // 等待响应阻塞 testWaitForTimeout(100); // 检查响应 checkResponse(); }time() vs testWaitForTimeout()函数阻塞用途time()否一般延时testWaitForTimeout()是测试等待2.4 定时器函数设置定时器variables { msTimer myTimer; } on start { setTimer(myTimer, 100); // 100ms 后触发 } on timer myTimer { write(定时器触发); setTimer(myTimer, 100); // 重新设置 }取消定时器killTimer(myTimer); // 取消定时器检查定时器if (timerActive(myTimer)) { write(定时器正在运行); }三、字符串函数3.1 strlen()功能获取字符串长度语法int len strlen(str);示例char message[100] Hello CAPL; int len strlen(message); write(长度%d, len); // 输出长度103.2 strcpy()功能复制字符串语法strcpy(destination, source);示例char src[100] Hello; char dest[100]; strcpy(dest, src); write(dest %s, dest); // 输出dest Hello注意目标缓冲区要足够大不会检查缓冲区溢出3.3 strcmp()功能比较字符串语法int result strcmp(str1, str2);返回值返回值说明0两字符串相等0str1 str20str1 str2示例char str1[100] Hello; char str2[100] Hello; char str3[100] World; if (strcmp(str1, str2) 0) { write(str1 等于 str2); } if (strcmp(str1, str3) ! 0) { write(str1 不等于 str3); }3.4 strcat()功能连接字符串语法strcat(destination, source);示例char str1[100] Hello; char str2[100] CAPL; strcat(str1, str2); write(str1 %s, str1); // 输出str1 Hello CAPL注意目标缓冲区要足够大不会检查缓冲区溢出3.5 strstr()功能查找子串语法char* pos strstr(str, substr);返回值找到返回子串位置指针未找到返回 NULL示例char message[100] Hello CAPL World; char* pos; pos strstr(message, CAPL); if (pos ! NULL) { write(找到子串); } else { write(未找到子串); }3.6 sprintf()功能格式化字符串语法sprintf(buffer, format, arg1, arg2, ...);示例char buffer[100]; int value 100; sprintf(buffer, value %d, value); write(buffer %s, buffer); // 输出buffer value 100 // 多个参数 int a 10, b 20; sprintf(buffer, a %d, b %d, a, b); write(buffer %s, buffer);应用场景构造日志消息格式化输出数据动态生成字符串四、数学函数4.1 abs()功能求绝对值语法int result abs(value);示例int a abs(10); // 10 int b abs(-10); // 10 write(a %d, b %d, a, b);4.2 sqrt()功能求平方根语法float result sqrt(value);示例float a sqrt(16); // 4.0 float b sqrt(2.0); // 1.414 write(a %f, b %f, a, b);4.3 pow()功能求幂语法float result pow(base, exponent);示例float a pow(2, 3); // 8.0 float b pow(10, 2); // 100.0 write(a %f, b %f, a, b);4.4 三角函数float angle 3.14159 / 4; // 45 度弧度 float sinVal sin(angle); // 正弦 float cosVal cos(angle); // 余弦 float tanVal tan(angle); // 正切 write(sin %f, cos %f, tan %f, sinVal, cosVal, tanVal);注意角度单位是弧度不是度转换弧度 度 × π / 1804.5 取整函数float f 3.7; int floorVal floor(f); // 3向下取整 int ceilVal ceil(f); // 4向上取整 int roundVal round(f); // 4四舍五入 write(floor %d, ceil %d, round %d, floorVal, ceilVal, roundVal);4.6 随机数函数// 生成 0-99 随机数 int r1 random(100); // 生成 -50 到 50 随机数 int r2 random(-50, 50); write(r1 %d, r2 %d, r1, r2);应用场景模拟随机事件生成测试数据压力测试五、报文操作函数5.1 发送相关// 发送报文 output(msg); // 设置周期发送 outputPeriod(msg, 100); // 100ms 周期 // 停止发送 outputStop(msg);5.2 接收相关on message msgName { // 读取报文 ID long id this.canID; // 读取 DLC int dlc this.dlc; // 读取数据字节 byte data0 this.byte(0); byte data1 this.byte(1); // 读取信号需要 DBC long speed $VehicleSpeed; }5.3 信号操作// 读取信号值 long speed $VehicleSpeed; // 设置信号值 msg.VehicleSpeed 100; // 检查信号是否存在 if (isSignalValid($VehicleSpeed)) { write(信号有效); }六、测试函数6.1 testStep 系列// 开始测试步骤 testStepBegin(测试步骤名); // 测试通过 testStepPass(通过原因); // 测试失败 testStepFail(失败原因); // 测试不确定 testStepInconclusive(不确定原因);完整示例on test { testStepBegin(TC001_正常值测试); // 测试代码 int result testFunction(); if (result 0) { testStepPass(测试通过); } else { testStepFail(测试失败错误码 %d, result); } }6.2 测试报告函数// 设置测试报告标题 testSetTitle(测试报告标题); // 添加测试报告内容 testSetAttribute(版本, 1.0); // 生成测试报告 testGenerateReport();七、文件操作函数7.1 文件打开long handle; // 只读打开 handle fileOpen(test.txt, FILE_READ); // 只写打开覆盖 handle fileOpen(test.txt, FILE_WRITE); // 追加打开 handle fileOpen(test.txt, FILE_APPEND); if (handle 0) { write(文件打开失败); }7.2 文件读取long handle; char buffer[100]; handle fileOpen(test.txt, FILE_READ); if (handle 0) { // 读取一行 fileReadLine(handle, buffer, sizeof(buffer)); write(读取内容%s, buffer); fileClose(handle); }7.3 文件写入long handle; handle fileOpen(log.txt, FILE_APPEND); if (handle 0) { fileWrite(handle, 日志内容\n); fileClose(handle); }7.4 文件操作// 删除文件 fileDelete(test.txt); // 重命名文件 fileRename(old.txt, new.txt); // 检查文件是否存在 if (fileExists(test.txt)) { write(文件存在); }八、系统函数8.1 获取系统信息// 获取系统时间 long sysTime getSystemTime(); // 获取计算机名 char computerName[100]; getComputerName(computerName, sizeof(computerName)); write(计算机名%s, computerName);8.2 执行外部程序// 执行命令 execute(notepad.exe); // 执行带参数命令 execute(cmd.exe /c dir);九、实用代码片段9.1 格式化输出时间proc void printTimestamp() { long time timeNow(); long sec time / 1000; long ms time % 1000; write([%d.%03d] , sec, ms); } on start { printTimestamp(); write(程序启动); }9.2 数据日志variables { long logHandle; } on start { logHandle fileOpen(data_log.txt, FILE_WRITE); fileWrite(logHandle, Time,Value\n); } on message EngineSpeed { char buffer[100]; sprintf(buffer, %d,%d\n, timeNow(), $EngineSpeed); fileWrite(logHandle, buffer); } on end { fileClose(logHandle); }9.3 超时检测variables { msTimer timeoutTimer; boolean msgReceived; } on start { setTimer(timeoutTimer, 1000); // 1 秒超时 } on message EngineSpeed { msgReceived true; resetTimer(timeoutTimer); setTimer(timeoutTimer, 1000); } on timer timeoutTimer { if (!msgReceived) { write(EngineSpeed 信号超时); } msgReceived false; setTimer(timeoutTimer, 1000); }9.4 报文统计variables { long msgCount; long byteCount; } on message * { msgCount; byteCount this.dlc; // 每 100 个报文输出一次统计 if (msgCount % 100 0) { write(收到%d个报文共%d字节, msgCount, byteCount); } } on end { write(总计%d个报文%d字节, msgCount, byteCount); }9.5 字符串处理proc void trimString(char str[]) { // 去除首尾空格简化版 int len strlen(str); if (len 0 str[len-1] ) { str[len-1] \0; } } on start { char message[100] Hello CAPL ; trimString(message); write(trim 后%s, message); }十、函数速查表10.1 输出函数函数用途示例write()格式化输出write(value %d, v)writeHex()十六进制输出writeHex(0x%x, v)output()发送报文output(msg)10.2 时间函数函数用途示例timeNow()获取当前时间long t timeNow()time()延时非阻塞time(100)testWaitForTimeout()测试等待阻塞testWaitForTimeout(100)setTimer()设置定时器setTimer(timer, 100)10.3 字符串函数函数用途示例strlen()字符串长度strlen(str)strcpy()字符串复制strcpy(dest, src)strcmp()字符串比较strcmp(s1, s2)strcat()字符串连接strcat(s1, s2)strstr()查找子串strstr(str, sub)sprintf()格式化字符串sprintf(buf, %d, v)10.4 数学函数函数用途示例abs()绝对值abs(-10)sqrt()平方根sqrt(16)pow()幂运算pow(2, 3)sin()/cos()/tan()三角函数sin(3.14/2)floor()/ceil()取整floor(3.7)random()随机数random(100)10.5 测试函数函数用途示例testStepBegin()开始测试步骤testStepBegin(TC001)testStepPass()测试通过testStepPass(通过)testStepFail()测试失败testStepFail(失败)10.6 文件函数函数用途示例fileOpen()打开文件fileOpen(test.txt, FILE_READ)fileRead()读取文件fileRead(h, buf, len)fileWrite()写入文件fileWrite(h, data)fileClose()关闭文件fileClose(h)十一、练习题目练习 1格式化输出// 要求用 write() 输出以下信息 // 当前时间XXX ms计数器XXX练习 2字符串处理// 要求用 sprintf() 构造消息 // 报文 ID: 0xXXX, 数据XXX练习 3超时检测// 要求实现 2 秒超时检测 // 超时后输出超时练习 4数据日志// 要求将收到的报文记录到文件 // 格式时间ID, 数据练习 5报文统计// 要求统计每种 ID 的报文数量 // 每 10 秒输出一次统计结果十二、常见问题Q1write() 输出不显示答检查 CANoe 的 Write 窗口是否打开。菜单View → Write WindowQ2定时器不触发答检查以下几点定时器变量是否在 variables 块定义是否调用了 setTimer()on timer 事件名是否正确Q3文件写入失败答检查以下几点文件路径是否正确是否有写权限文件是否被其他程序占用是否调用了 fileClose()Q4字符串函数乱码答确保文件保存为 UTF-8 编码尽量用英文字符串中文字符串用 char 数组存储十三、学习建议13.1 记忆方法不要死记硬背要分类记忆— 按功能分类输出、时间、字符串…理解记忆— 理解函数用途实践记忆— 多用就记住了速查表— 写代码时查阅13.2 练习建议每个函数都试试— 写小程序测试组合使用— 多个函数配合实际项目— 在项目中应用总结归纳— 建立自己的速查表13.3 推荐练习顺序第 1 天输出函数write、output 第 2 天时间函数timeNow、定时器 第 3 天字符串函数strlen、strcpy、sprintf 第 4 天数学函数abs、sqrt、random 第 5 天测试函数testStep 系列 第 6 天文件函数fileOpen、fileWrite 第 7 天综合练习写在最后CAPL 常用函数就这些。难吗不难多用就记住了。关键是什么多练习多在实际项目中使用。这篇教程里的所有代码我都建议你亲手敲一遍。只有亲手敲过才是你的知识。建议收藏这篇写脚本时随时查阅。用多了常用函数就记住了。下一篇预告《第一个 CAPL 脚本信号测试》完整项目示例从 0 到 1 编写运行和调试扩展练习如果本文对你有帮助欢迎点赞、收藏、关注专栏第一时间获取更新有任何问题欢迎在评论区留言我会逐一回复。练习答案会在第 4 篇公布先自己试试看