如何使用Matlab Data/Engine API for C++加载.mat文件？

我刚好熟悉Matlab的新C++ API，这就给你详细说下怎么用它加载.mat文件，完美避开旧API的兼容性问题！

核心实现思路 #

你完全可以用Matlab的C++ Data Array API来读取.mat文件，全程不需要依赖旧的mat.h头文件，从根源上避免兼容性冲突。核心是借助matlab::engine::MATFile类完成文件操作，再通过类型匹配解析变量数据。

完整代码示例 #

#include <matlab/engine/matlabengine.hpp>
#include <matlab/data/Array.hpp>
#include <iostream>
#include <string>

int main() {
    try {
        // 1. 初始化MATFile对象并打开目标.mat文件
        const std::string mat_file_path = "your_target_file.mat";
        matlab::engine::MATFile mat_file = matlab::engine::openMATFile(mat_file_path);

        // 2. 读取指定名称的变量（示例读取名为"sample_matrix"的变量）
        matlab::data::Array target_array = mat_file.read("sample_matrix");

        // 3. 根据变量类型解析数据，这里以二维double矩阵为例
        if (target_array.getType() == matlab::data::ArrayType::DOUBLE && target_array.is2D()) {
            matlab::data::TypedArray<double> double_matrix = target_array;
            // 遍历并输出矩阵元素
            for (size_t row = 0; row < double_matrix.getDimensions()[0]; ++row) {
                for (size_t col = 0; col < double_matrix.getDimensions()[1]; ++col) {
                    std::cout << double_matrix[row][col] << " ";
                }
                std::cout << std::endl;
            }
        }
        else {
            std::cout << "目标变量不是二维double矩阵，请根据实际类型调整解析逻辑" << std::endl;
        }

        // 4. 手动关闭文件（也可依赖MATFile的析构函数自动关闭）
        mat_file.close();
    }
    catch (const std::exception& e) {
        std::cerr << "加载.mat文件时出错: " << e.what() << std::endl;
        return 1;
    }
    return 0;
}

关键注意事项 #

• 若要获取文件中所有变量的名称，可调用mat_file.getVariableNames()方法，它会返回包含所有变量名的std::vector<std::string>
• 针对不同类型的变量（如字符数组、单元格数组），需要使用对应的专用类型（比如CellArray、CharArray）进行转换，适配Matlab C++ API的类型系统
• 确保你的Matlab版本在R2018b及以上，这个版本才正式支持C++ Data Array API
• 编译时要正确链接Matlab提供的相关库（Windows下为libmatlabengine.lib，Linux/macOS下为libmatlabengine.so）

这样用纯新API就能完成.mat文件的加载操作，完全不需要接触旧的C API，自然也就不存在内部兼容性问题啦！

内容的提问来源于stack exchange，提问作者David W. Romero