前向声明与头文件依赖

1. 基础概念

1
class Student;

这叫前向声明:告诉编译器 Student 是一个类,但尚未给出其成员和布局。此时 Student 是不完整类型。

完整定义则说明类内部有哪些成员:

1
2
3
4
5
class Student {
    int score_ = 0;
public:
    int score() const { return score_; }
};

2. 什么时候可以只用前向声明?

只声明指针、引用,以及某些函数接口时,不必知道对象内部布局:

1
2
3
4
5
class Student;
Student* p = nullptr;
void print(const Student& student);
Student makeStudent();          // 这里只声明,不定义函数
void process(Student student);  // 按值参数的函数声明也可以

声明指针时,编译器不需要知道被指向对象的完整大小。但如果要定义 Student 对象、访问成员、计算 sizeof(Student),或者把 Student 作为按值数据成员,就需要完整定义。函数的按值声明可以使用不完整类型,不意味着相关函数定义和调用也可以始终只靠前向声明。

3. 头文件与源文件的配合

1
2
3
4
5
6
7
8
// Classroom.hpp
class Student;
class Classroom {
    Student* leader_ = nullptr;  // 不拥有这个学生对象
public:
    void setLeader(Student* student) { leader_ = student; }
    int leaderScore() const;
};
1
2
3
4
5
6
7
// Classroom.cpp
#include "Classroom.hpp"
#include "Student.hpp"          // 此处提供 Student 的完整定义

int Classroom::leaderScore() const {
    return leader_ ? leader_->score() : 0;
}

头文件只保存指针,因此可以减少包含依赖;源文件真正调用 Student 成员时再包含其头文件。这里 leader_ 不负责释放对象,调用者应保证学生对象在访问期间仍然存在。

4. 相互关联的类

1
2
3
4
5
6
7
class B;
class A {
    B* partner_ = nullptr;
};
class B {
    A* partner_ = nullptr;
};

两个类可以通过指针关联。不能让两个类都按值直接包含对方,那样对象大小会形成无法结束的递归。

5. 注意事项

  • include guard 或 #pragma once 解决重复包含,前向声明解决在完整定义之前识别类型,两者不能互相替代。
  • 从某个类派生时,需要知道基类的完整定义。
  • 不要自行向 namespace std 添加标准库类型的前向声明。需要流类型声明时可以使用标准头文件 <iosfwd>。
  • 不是每个地方都应该用前向声明。只在完整定义确实不必要时使用,避免为了减少 include 破坏代码可读性。
使用 Hugo 构建
主题 Stack 由 Jimmy 设计