C++调用MATLAB引擎读写.mat文件指南

环境准备与工程配置

要在C++程序中操作MATLAB数据，首先需确保编译器能找到MATLAB的外部接口头文件与库文件。假设使用的是64位系统（如Win7 64位）和对应的64位MATLAB（如R2010b），配置需在Visual Studio中进行：

第1步：添加包含目录与库目录
在项目的属性页中，进入VC++目录：

• 包含目录：添加 MATLAB\R2010b\extern\include 及 MATLAB\R2010b\extern\include\win64。
• 库目录：添加 MATLAB\R2010b\extern\lib\win64\microsoft（若混用32位库也可同时添加 win32 路径）。

第2步：链接依赖库
进入链接器 -> 输入 -> 附加依赖项，添加以下核心库：
libmat.lib
libmx.lib
libmex.lib
libeng.lib

第3步：配置平台与目标计算机
由于MATLAB通常是64位应用，C++工程需匹配其架构：
1. 点击顶菜单 生成 -> 配置管理器 -> 平台，将平台设置为 X64。
2. 在链接器 -> 高级 -> 目标计算机中，选择 MachineX64(/MACHINE:X64)。

第4步：设置环境变量
为避免运行时找不到DLL，需将MATLAB的库路径加入系统的Path环境变量中（或在程序启动时动态加载），例如：
E:\DevTools\MATLAB\R2010b\extern\lib\win64\microsoft
E:\DevTools\MATLAB\R2010b\bin\win64

C++读写.mat文件核心操作

引入必要的头文件 #include <mat.h>，即可使用MAT文件接口进行数据存取。以下为完整操作流程示例：

// --- 读取 .mat 文件 ---
// 定义指针并初始化
MATFile *pmatFile = NULL;
mxArray *pMxArray = NULL;
double *initA;

// 1. 打开文件，模式为只读 "r"
pmatFile = matOpen("initUrban.mat", "r");
if (pmatFile == NULL) {
    // 处理错误：文件不存在或无法打开
}

// 2. 获取变量名对应的 mxArray 指针
// 假设文件中包含名为 "initA" 的双精度矩阵
pMxArray = matGetVariable(pmatFile, "initA");

// 3. 获取矩阵维数
size_t M = mxGetM(pMxArray); // 行数
size_t N = mxGetN(pMxArray); // 列数

// 4. 提取实际数据指针
initA = (double*) mxGetData(pMxArray);

// 5. 数据处理与转换
// 注意：MATLAB矩阵是按列优先（Column-major）存储的，即先存第一列的所有行元素
// C++二维数组通常按行访问，此处需做索引映射
Matrix<double> A(M, N); 
for (int i = 0; i < M; i++) {
    for (int j = 0; j < N; j++) {
        // 关键：下标转换，C++中 A[i][j] 对应线性内存中的位置
        A[i][j] = initA[M * j + i]; 
    }
}

// 6. 清理资源
mxFree(initA);
matClose(pmatFile);
pMxArray = NULL;


// --- 写入 .mat 文件 ---
double *outA = new double[M * N];
// 此处省略 outA 的数据填充过程，假设已完成赋值

// 1. 重新创建或复用 mxArray（写入时通常需要构建新的 mxArray）
// 在实际应用中，建议使用 mxCreateDoubleMatrix 创建新对象，而非复用旧对象
// 这里仅展示写入接口的基本调用逻辑：

pmatFile = matOpen("A.mat", "w"); // "w" 模式表示写入/新建
if (pmatFile != NULL) {
    // 注意：直接对 pMxArray 使用 mxSetData 需谨慎，建议针对新数据创建新 mxArray
    // 伪代码示意：
    // mxArray *newArray = mxCreateDoubleMatrix(M, N, mxREAL);
    // mxSetPr(newArray, outA);
    // matPutVariable(pmatFile, "A", newArray);
    
    // 原文示例中的简略写法（存在潜在风险，生产环境建议标准创建流程）：
    // mxSetData(pMxArray, outA);
    // matPutVariable(pmatFile, "A", pMxArray);
    
    matClose(pmatFile);
}
delete[] outA;

常用函数说明

以下是处理Mat文件的核心API及其参数含义：

1. matOpen: 打开MAT文件

声明：MATFile *matOpen(const char *filename, const char *mode)

模式参数 mode 详解：

• r：以只读方式打开。文件必须存在。
• w：以写入方式打开。若文件不存在则自动创建，若存在则覆盖原有内容。
• u：更新模式（Update）。可读可写，但如果指定的文件不存在，不会创建新文件，而是返回NULL。

2. matGetVariable: 读取变量

声明：mxArray *matGetVariable(MATFile *pMF, const char *name)

作用：从已打开的文件中提取指定名称的数据阵列（mxArray），返回该数据的指针。若未找到变量，返回NULL。

3. mxGetData: 获取数据指针

声明：void *mxGetData(const mxArray *pa)

作用：返回存储在mxArray中的原始数据首地址。**务必注意**：返回类型为void指针，使用时必须进行强制类型转换（如转为 double*、char* 等），且数据类型需与实际存储一致（可通过mxGetClassID判断）。

4. mxGetM / mxGetN: 获取维度

声明：size_t mxGetM(const mxArray *pa) / size_t mxGetN(const mxArray *pa)

作用：分别返回矩阵的行数和列数。对于非标量数据，这两个值决定了数据的总大小。

5. matPutVariable: 写入变量

声明：int matPutVariable(MATFile *pMF, const char *name, const mxArray *pA)

作用：将mxArray数据以指定名称存入mat文件中。成功返回0，出错返回非0值。

注意事项：内存存储顺序差异

这是C++处理MATLAB数据时最容易出错的环节。MATLAB矩阵采用列优先（Column-Major）存储，而C/C++的多维数组通常在逻辑上理解为行优先（Row-Major）访问。例如，一个M×N的矩阵，在线性内存中，A[0][1]（第二列第一行）的物理地址紧跟在 A[0][0] 之后，而不是 A[1][0]。

因此，在遍历或重塑数据结构时，索引计算需遵循公式：线性索引 = 行索引 + 行数 × 列索引。在处理大规模数据导出导入时，确认数据排列是否正确是验证结果的关键。

以上就是在C++中通过MATLAB接口读写Mat文件的详细内容，更多关于C++调用第三方库的资料请关注本站其它相关文章！