C++将结构体移入头文件报错：仅靠返回类型无法重载函数

原代码在单个main.cpp中可正常运行，但拆分到header.h、header.cpp和main.cpp后，header.cpp中my_fftw_allocate_cplx函数定义处出现编译错误：

cannot overload functions distinguished by return type alone

错误原因 #

header.cpp中重复定义了cplx_buffer结构体。由于header.cpp已经通过#include "header.h"引入了该结构体的定义，此时再重新定义一次，会让编译器认为头文件的cplx_buffer和cpp文件内的cplx_buffer是两个完全不同的类型。而my_fftw_allocate_cplx函数的声明使用的是头文件的类型，定义却使用了cpp内的类型，编译器将其判定为“仅通过返回类型重载函数”，这违反了C++重载规则，因此报错。

修复方案 #

1. 修改header.h（添加头文件保护、移除全局命名空间声明） #

#ifndef HEADER_H
#define HEADER_H

#include <complex>
#include <fftw3.h>
#include <iostream>
#include <iomanip>

static const int nx = 10;
static const int ny = 10; 

struct cplx_buffer
{
  fftw_complex* a;
  int rows;
  int cols;

  fftw_complex& operator()(int i, int j) const { return a[i * cols + j]; }
};

void print_matrix(cplx_buffer const& m);
cplx_buffer my_fftw_allocate_cplx(int x, int y);

#endif // HEADER_H

2. 修改header.cpp（删除重复的结构体定义） #

#include "header.h"
using namespace std;

cplx_buffer my_fftw_allocate_cplx(int x, int y) { 
    return cplx_buffer{ fftw_alloc_complex(x * y), x, y }; 
}

void print_matrix(cplx_buffer const& m)
{
  cout << fixed << setprecision(2);
  for (int i = 0; i < m.rows; i++)
  {
    for (int j = 0; j < m.cols; j++)
    {
      cout << setw(16) << complex<double> { m(i, j)[0], m(i, j)[1] };
    }
    cout << '\n';
  }
  cout << '\n';
}

3. main.cpp保持不变 #

#include "header.h" 
using namespace std;

int main(){
    cplx_buffer outY = my_fftw_allocate_cplx((ny+1), nx);
    // stuff
}

额外说明 #

• 头文件保护宏是必要的，避免多个文件包含头文件时导致结构体重复定义。
• 头文件中避免使用using namespace std;，防止污染全局命名空间，建议在cpp文件中使用该声明简化代码。
• 确保所有依赖的头文件都被正确包含，比如fftw3.h、<iomanip>等，否则可能出现类型未定义的错误。

内容的提问来源于stack exchange，提问作者Jamie