4. CAPL编程基础

各位同学，咱们今天聊点实在的。写CAPL脚本，说白了就是在跟数据打交道。你发报文、收信号、做判断、算时间，哪一步离得开变量？数据类型和变量，就是脚本的“地基”。地基没打好，后面盖的楼再漂亮也得塌。

我刚开始带项目那会儿，有个同事写了个CANoe脚本，跑起来总报错。查了两天，最后发现是一个int变量存了一个超过范围的值，直接溢出了。从那以后，我每次培训都强调：先把数据类型搞明白，再动手写代码。

4.1 基本数据类型：CAPL的“积木块”

CAPL的基本数据类型，我习惯把它们分成三类：整数型、浮点型、字符型。咱们一个一个看。

4.1.1 整数型：int、byte、dword、word、long

整数型用得最多，也最容易踩坑。我列个表，你一看就明白。

类型	位宽	取值范围	典型用途
byte	8位	0 ~ 255	存单个字节、信号值
word	16位	0 ~ 65535	存CAN ID、计数器
dword	32位	0 ~ 4294967295	存时间戳、大数值
int	32位	-2147483648 ~ 2147483647	通用有符号整数
long	64位	±9.22e18	超大数值、精确计数

注意看，byte、word、dword都是无符号的，而int和long是有符号的。这个区别很要命。

举个例子，你写个计数器：

// 错误示范：计数器可能超过255
byte counter = 0;
counter = counter + 1;  // 到256就变回0了

// 正确做法
word counter = 0;
counter = counter + 1;  // 能数到65535

4.1.2 浮点型：float

CAPL里浮点型就一个——float，32位单精度。够用吗？说实话，做汽车电子测试，大部分场景都够了。你要算个电压、温度、角度，float完全能搞定。

float voltage = 12.5;
float temperature = 85.3;
float angle = 45.0;

但要注意，float有精度问题。你想想看，0.1在二进制里是无限循环小数。所以别拿float做精确的金额计算或循环判断。

4.1.3 字符型：char

char在CAPL里就是8位ASCII字符。单个字符用单引号：

char c = 'A';
char digit = '5';

字符串呢？CAPL没有专门的字符串类型，你得用字符数组。这个后面讲数组时会细说。

4.2 枚举与结构体：让代码更“像人话”

基本类型用多了，你会发现一个问题：代码里全是数字，读起来费劲。比如：

int state = 2;  // 2代表啥？谁记得住？

这时候，枚举和结构体就派上用场了。

4.2.1 枚举：给数字起个名字

枚举说白了，就是把一堆相关的常量打包，给每个值起个名字。我习惯在测试脚本里用枚举表示状态机、错误码、模式选择。

enum eState {
  eIdle = 0,
  eActive = 1,
  eError = 2,
  eSleep = 3
};

enum eState currentState = eIdle;

if (currentState == eError) {
  write("系统出错了！");
}

你看，eError比2好理解多了吧？

4.2.2 结构体：把相关数据“捆”在一起

结构体就是把多个不同类型的数据打包成一个整体。比如你要描述一个CAN报文：

struct sCanMessage {
  dword id;
  byte dlc;
  byte data[8];
  dword timestamp;
};

struct sCanMessage msg;
msg.id = 0x123;
msg.dlc = 8;
msg.data[0] = 0xAA;
msg.timestamp = timeNow();

结构体最大的好处是：传参方便、逻辑清晰。你想想看，要是没有结构体，你得传4个参数，顺序还不能搞错。有了结构体，一个变量全搞定。

4.3 全局变量与局部变量：谁该在哪儿待着？

这个问题，我见过太多人搞混了。咱们用一张图说清楚。

4.3.1 全局变量：写在variables块里

全局变量定义在脚本文件顶部的variables {}块中。整个脚本里所有函数都能读写它。

variables {
  int g_counter = 0;        // 全局计数器
  word g_errorCount = 0;    // 全局错误计数
  float g_batteryVoltage;   // 全局电池电压
}

on start {
  g_counter = 0;
}

on timer 100ms {
  g_counter++;
  if (g_counter > 100) {
    g_counter = 0;
  }
}

4.3.2 局部变量：写在函数里

局部变量只在当前函数内有效。函数一结束，变量就“消失”了。

void MyFunction() {
  int localCounter = 0;     // 局部变量
  localCounter++;
  write("localCounter = %d", localCounter);
}

on start {
  MyFunction();  // 输出：localCounter = 1
  MyFunction();  // 输出：localCounter = 1（每次都是新的）
}

你想想看，每次调用MyFunction，localCounter都是新创建的。这就是局部变量的特性——每次调用都“重置”。

4.4 变量作用域：谁看得见谁？

作用域说白了就是“可见范围”。CAPL的作用域规则其实很简单：

• 全局变量：整个文件可见，所有函数都能用
• 局部变量：只在定义它的函数内可见
• 块作用域：在{}块内定义的变量，只在该块内可见

举个例子：

variables {
  int g_val = 10;  // 全局变量
}

void TestScope() {
  int g_val = 20;  // 局部变量，和全局变量同名
  write("局部g_val = %d", g_val);  // 输出20
  
  {
    int inner = 99;  // 块作用域变量
    write("inner = %d", inner);  // 输出99
  }
  
  // write("inner = %d", inner);  // 这行会报错！inner已不可见
}

on start {
  TestScope();
  write("全局g_val = %d", g_val);  // 输出10，全局变量没被改
}

4.5 实战经验：变量命名与初始化

最后，分享几个我这些年总结出来的“血泪教训”：

原则	说明	示例
命名要有意义	别用a、b、tmp这种	engineSpeed 比 es 好
加前缀区分类型	全局变量加g_，枚举加e	g_errorCount、eState
变量必须初始化	CAPL不会自动清零	int counter = 0;
能用局部别用全局	减少耦合，方便调试	临时计算用局部变量