面试题：C++函数声明注释规范 - 高级难度

Question

假设有一个处理复杂矩阵运算的C++函数 `void matrixOperation(double** matrix, int rows, int cols)`，请按照规范为其添加详细注释，注释除了常规的功能、参数、返回值说明外，还需提及可能出现的异常情况及处理方式。

Answer 1

/**
 * @brief 执行复杂矩阵运算的函数。
 *
 * 此函数用于对给定的二维矩阵执行一系列复杂的数学运算。这些运算可能包括但不限于矩阵乘法、求逆、特征值计算等。
 *
 * @param matrix 指向二维数组的指针，表示输入的矩阵。矩阵的内存应由调用者分配，且内存布局应为连续的二维数组形式。
 * @param rows 矩阵的行数。必须为正整数，否则函数行为未定义。
 * @param cols 矩阵的列数。必须为正整数，否则函数行为未定义。
 *
 * @return 此函数无返回值。
 *
 * @exception 可能出现的异常情况及处理方式：
 * - **内存访问异常**：如果 `matrix` 指针为空，或者 `matrix` 指向的内存不足 `rows * cols` 个 `double` 类型的元素，将导致未定义行为。调用者应确保正确分配并初始化 `matrix` 所指向的内存。
 * - **数学运算异常**：在执行复杂矩阵运算过程中，如果遇到不满足数学运算条件的情况，例如矩阵求逆时矩阵不可逆，可能会抛出特定的数学异常（具体取决于所使用的数学库）。此时，函数应捕获异常并向调用者返回合适的错误信息（如果有返回值的设计可以这样处理，此函数无返回值可通过日志记录等方式告知调用者异常），同时清理已分配的临时资源（如果有）。
 */
void matrixOperation(double** matrix, int rows, int cols) {
    // 函数实现代码
}