控制 C 代码的样式

关于本教程

学习目标

本教程将向您说明如何：

以 switch-case 语句的形式为 if-elseif-else 决策逻辑生成代码。
使用 MATLAB^® Coder™ App 从 MATLAB 代码中生成 C 代码。
在 MATLAB Coder 工程中配置代码生成配置参数。
创建代码生成报告，您可以使用该报告在原始 MATLAB 代码和生成的 C 代码之间进行追溯。

需要的产品

本教程需要以下产品：

MATLAB
MATLAB Coder
C 编译器
MATLAB Coder 将查找并使用支持的已安装编译器。请参阅 MathWorks^® 网站上支持和兼容的编译器。
可以使用 mex -setup 更改默认编译器。请参阅更改默认编译器。

需要的文件

类型	名称	描述
函数代码	`test_code_style.m`	使用 `if-elseif-else` 的 MATLAB 示例。

在本地工作文件夹中创建文件

创建一个本地工作文件夹，例如 c:\ecoder\work。

创建包含以下代码的文件 test_code_style.m：

function y = test_code_style(x) 
%#codegen

if (x == 1)
    y = 1;
elseif (x == 2)
    y = 2;
elseif (x == 3)    
    y = 3;
else
    y = 4;
end

打开 MATLAB Coder

在 MATLAB 工具条的 App 选项卡上，点击代码生成下的 MATLAB Coder 图标。

该 App 会打开选择源文件页面。

指定源文件

在选择源文件页面中，键入或选择入口函数 test_code_style.m 的名称。
在工程位置字段中，将工程名称更改为 code_style.prj。
点击下一步以转到定义输入类型步骤。该 App 将分析函数以查找编码问题并确定代码生成就绪情况。如果 App 发现问题，它将打开检查代码生成就绪性页面，您可以在其中查看和解决问题。在此示例中，由于 App 没有检测到问题，因此将打开定义输入类型页面。

定义输入类型

由于 C 代码使用静态类型，因此在编译时，代码生成器必须确定 MATLAB 文件中所有变量的属性。因此，您必须指定所有函数输入的属性。要定义输入 x 的属性，请执行以下操作：

点击自行直接键入输入类型或全局类型。
点击 x 右侧的字段。
从选项列表中选择 int16，然后选择标量。
点击下一步以转到检查运行时问题步骤。

注意

将 if-elseif-else 模式转换为 switch-case 语句优化仅对整数和枚举类型的输入有效。

检查运行时问题

检查运行时问题步骤从您的入口函数生成 MEX 文件，然后运行 MEX 函数并报告问题。此步骤是可选的。不过，建议最好执行此步骤。通过此步骤，可以检测并解决在生成的 C 代码中更难诊断出来的运行时错误。默认情况下，MEX 函数包括内存完整性检查。这些检查执行数组边界和维度检查，还检测为 MATLAB 函数生成的代码中是否存在内存完整性冲突问题。有关详细信息，请参阅Control Run-Time Checks。

要打开检查运行时问题对话框，请点击检查问题箭头。
在检查运行时问题对话框中，输入使用示例输入调用 test_code_style 的代码。对于此示例，输入 test_code_style(int16(4))。
点击检查问题。
App 将生成一个 MEX 函数。它将运行带示例输入的 MEX 函数。如果 App 在 MEX 函数生成或执行过程中检测到问题，它将提供警告和错误消息。您可以点击这些消息，导航到有问题的代码并修复问题。在本示例中，App 未检测到问题。
点击下一步以转到生成代码步骤。

配置代码生成参数

要打开生成对话框，请点击生成箭头。
将编译类型设置为静态库(.lib)。
点击更多设置并设置以下设置：
- 在代码外观选项卡上，选中将 if-elseif-else 模式转换为 switch-case 语句复选框。
- 在调试选项卡上，确保已选择始终创建报告。
- 在所有设置选项卡上，确保已选择启用代码可追溯性。