（0）——C++：制作头文件的意义及方法

目录

1.制作头文件的意义

1.1 比较函数

1.2 数据结构

1.3 工具函数

2.制作头文件的方法

---

1.制作头文件的意义

C++制作头文件的意义在于将一些常用的代码片段或函数封装成一个模块，方便在多个源程序中重复使用，提高代码的可维护性和复用性。一般情况下，头文件包含函数、类、全局变量等可供其他源程序调用的信息，而源程序则包含具体实现。如果一个程序中有多个函数和数据结构需要在多个源文件中使用，那么将它们放在一个头文件中可以减少重复代码的编写，避免出现错误，并且方便维护。

下面是一些制作头文件的例子：

1.1 比较函数

比较函数是一个常用的函数，可以对不同类型的数据进行比较，例如整数、浮点数、字符串等。如果在程序中多次使用比较函数，将它们封装在一个头文件中可以提高代码的可读性和可维护性，例如：

#ifndef COMPARE_FUNCTIONS_H
#define COMPARE_FUNCTIONS_H

template <typename T>
int cmp(T a, T b) {
    if (a < b) {
        return -1;
    } else if (a > b) {
        return 1;
    } else {
        return 0;
    }
}

#endif

在上面的头文件中，使用了模板函数cmp，可以对任意类型的数据进行比较，并返回比较结果。

1.2 数据结构

数据结构是程序中常用的一种数据类型，例如链表、树和图等。如果在多个源文件中使用相同的数据结构，将它们封装在一个头文件中可以提高代码的可维护性和可读性。

例如，在一个程序中需要使用链表，可以将链表的定义和操作封装在一个头文件中：

#ifndef LINKED_LIST_H
#define LINKED_LIST_H

template <typename T>
struct ListNode {
    T val;
    ListNode<T>* next;

    ListNode(T v) : val(v), next(nullptr) {}
};

template <typename T>
class LinkedList {
private:
    ListNode<T>* head;

public:
    LinkedList() : head(nullptr) {}

    void insert(T val) {
        if (head == nullptr) {
            head = new ListNode<T>(val);
        } else {
            ListNode<T>* p = head;
            while (p->next != nullptr) {
                p = p->next;
            }
            p->next = new ListNode<T>(val);
        }
    }

    void print() {
        ListNode<T>* p = head;
        while (p != nullptr) {
            std::cout << p->val << " ";
            p = p->next;
        }
        std::cout << std::endl;
    }
};

#endif

在上面的头文件中，定义了一个链表结构体ListNode和一个链表类LinkedList，并提供了插入和打印操作。在其他源文件中可以通过#include "linked_list.h"来引入该头文件，并使用链表结构和操作。

1.3 工具函数

工具函数是一些不依赖于程序逻辑的函数，例如字符串处理函数、文件操作函数等。将它们封装在一个头文件中可以提高代码的可读性和可维护性。

例如，在一个程序中需要对日期进行处理，可以将日期的解析和格式化函数封装在一个头文件中：

#ifndef DATE_UTIL_H
#define DATE_UTIL_H

#include <string>
#include <sstream>
#include <iomanip>

struct Date {
    int year;
    int month;
    int day;
};

Date parse_date(std::string str) {
    std::stringstream ss(str);
    std::string year, month, day;
    std::getline(ss, year, '-');
    std::getline(ss, month, '-');
    std::getline(ss, day, '-');
    return {std::stoi(year), std::stoi(month), std::stoi(day)};
}

std::string to_string(Date date) {
    std::stringstream ss;
    ss << std::setfill('0') << std::setw(4) << date.year << "-"
       << std::setw(2) << date.month << "-"
       << std::setw(2) << date.day;
    return ss.str();
}

#endif

在上面的头文件中，定义了一个日期结构体Date和两个工具函数parse_date和to_string，可以将字符串格式的日期解析成Date结构体，并将Date结构体格式化成字符串。在其他源文件中可以通过#include "date_util.h"来引入该头文件，并使用日期解析和格式化函数。

2.制作头文件的方法

1. 创建头文件，文件名以.h为后缀；

2. 在头文件中写入函数、类、全局变量等需要导出的信息，并加上命名空间、宏定义、注释等必要的内容；

3. 在需要使用该头文件的源程序中引用该头文件，在源程序的开头使用#include指令；

4. 编译源程序时，会自动将头文件和源程序进行合并，生成可执行文件。

下面是头文件的一个示例：

#ifndef MYHEADER_H
#define MYHEADER_H

namespace MyNamespace {
    int add(int a, int b); //加法函数声明
    int sub(int a, int b); //减法函数声明

    class MyClass {
    public:
        void print(); //打印函数声明
    };

    extern int globalValue; //全局变量声明
}

#endif

在上面的示例中，使用了ifndef、define和endif宏定义来防止多次包含同一头文件。其中，namespace关键字用于定义命名空间，可以避免命名冲突。声明了两个函数add和sub，以及一个类MyClass和一个全局变量globalValue。在其他源程序中使用该头文件时，只需要在开头使用#include"myheader.h"即可。