C语言基础语法之声明与头文件.h【小白也可以看懂系列】

【学习自用】

什么是声明？

在C语言中，"声明"是指对变量、函数、或其他程序实体进行提前声明或告知编译器它们的类型和名称，以便编译器在后续代码中正确解释和使用这些实体。声明是一种介绍或引导编译器，告诉编译器在程序中会有一些实体，以及这些实体的类型和名称。

在C语言中，通常有两种主要的声明：

1.变量声明：用于告诉编译器关于变量的信息，包括变量的类型和名称。变量声明通常发生在函数的开始或作用域的开始，以便在后续代码中可以使用这些变量。

int x;  // 变量声明，告诉编译器会有一个整数类型的变量 x

2.函数声明：用于告诉编译器关于函数的信息，包括函数的返回类型、函数名以及参数列表。函数声明使得编译器在后续代码中能够正确识别和调用这个函数。

int add(int a, int b);  // 函数声明，告诉编译器会有一个名为 add 的函数，接受两个整数参数并返回一个整数

声明的主要目的是为了避免编译器在遇到变量或函数时产生错误，因为在使用它们之前，编译器可能并不知道这些实体的具体类型和名称。通过提前声明，编译器能够正确地处理这些实体的引用。

另外，声明也允许将程序的不同部分分开编译，因为在一个文件中声明了一个变量或函数后，在其他文件中可以使用这个声明而无需重新定义。这有助于实现模块化的程序设计。

声明与定义的区别

1.声明 (Declaration):

作用： 告诉编译器某个变量、函数或其他程序实体的存在、类型和名称，但不分配内存或提供实际的实现。

extern int x;          // 变量 x 的声明
int add(int a, int b);  // 函数 add 的声明

2.定义 (Definition):

作用： 为变量、函数或其他程序实体分配内存并提供具体的实现。

int x = 10;           // 变量 x 的定义，分配内存并赋初值
int add(int a, int b)  // 函数 add 的定义
{
    return a + b;
}

3.区别：

声明是介绍或引导编译器，告诉它某个实体的类型和名称，但不进行实际的分配内存或提供实现。

定义除了告诉编译器实体的类型和名称外，还进行了内存分配和提供了实体的实际实现。

一个实体可以被声明多次，但只能被定义一次。

在程序中，通常在头文件中进行声明，而在源文件中进行定义。

// 声明（头文件中）
extern int x;          // 变量 x 的声明
int add(int a, int b);  // 函数 add 的声明

// 定义（源文件中）
int x = 10;             // 变量 x 的定义，分配内存并赋初值
int add(int a, int b)   // 函数 add 的定义
{
    return a + b;
}

总体而言，声明和定义的分离有助于实现模块化编程，其中头文件用于声明，源文件用于定义。这种分离也有助于减少编译时间和避免重复定义。

头文件.h文件的作用

声明函数和变量： 头文件通常包含对函数、变量、结构体等的声明。这样，其他源文件在包含这个头文件时就能知道这些函数、变量的存在和类型，而无需了解其具体实现。

提供接口： 头文件定义了模块或库的接口，即外部可见的函数和变量。通过头文件，用户可以了解如何使用这个模块或库的功能，而不必关心内部的实现细节。

避免重复定义： 头文件通常包含防止重复定义的预处理指令，比如 #ifndef、#define 和 #endif，以防止同一个头文件被多次包含。

提高代码的可读性和维护性： 将函数和变量的声明放在头文件中，使源文件更加简洁和易读。通过模块化的设计，提高代码的可维护性。

声明举例

如果变量 x 只在一个源文件中定义和使用，通常情况下不需要在头文件中声明。头文件主要用于声明那些在多个源文件中共享的函数、变量、宏等。

如果 x 只在一个源文件中使用，可以将它的声明和定义都放在该源文件中，而无需在头文件中声明。例如：

// 在源文件中
int x = 10;  // 变量 x 的定义

int add(int a, int b)
{
    return a + b;
}

然而，如果程序包含多个源文件，而且这些源文件都需要访问同一个全局变量 x，那么最好在头文件中声明它，以便在各个源文件中都能够访问到。例如：

// 在头文件中（.h文件）
extern int x;  // 变量 x 的声明

int add(int a, int b);  // 函数 add 的声明

// 在源文件中
int x = 10;  // 变量 x 的定义

int add(int a, int b)
{
    return a + b;
}

这样，其他源文件在需要使用 x 时，只需包含该头文件即可。

多个源文件需要调用同一个函数，如何在.h中声明

在头文件 example.h 中声明函数：

// example.h

#ifndef EXAMPLE_H
#define EXAMPLE_H

// 函数声明
int add(int a, int b);

#endif // EXAMPLE_H

在源文件 example.c 中定义函数：

// example.c

#include "example.h"

// 函数定义
int add(int a, int b) {
    return a + b;
}

在其他源文件中，如果需要调用 add 函数，只需包含头文件 example.h：

// other_file.c

#include "example.h"

int main() {
    int result = add(3, 4);
    // 其他代码...
    return 0;
}

这样，其他源文件就能够调用 add 函数而无需了解其具体实现。头文件的作用就是将程序模块化，使得各个源文件之间可以共享声明，而不需要暴露实现的细节。

避免重复定义#ifndef

#ifndef 是 C 语言中的条件编译预处理指令，用于防止头文件的多次包含，以避免编译错误或者符号重定义的问题。通常与 #define、#endif 一起使用。下面是 #ifndef 的基本用法：

#ifndef HEADER_FILE_NAME_H
#define HEADER_FILE_NAME_H

// 头文件的内容

#endif // HEADER_FILE_NAME_H

具体来说：
#ifndef：检查宏是否未定义。

#define HEADER_FILE_NAME_H：定义一个宏，表示当前头文件的标识符，可以是任何唯一的标识符。

// 头文件的内容：头文件的实际内容写在这个部分。
#endif：结束条件编译块。

// HEADER_FILE_NAME_H：注释，用于标识 #ifndef 和 #endif 之间的条件编译块。

使用 #ifndef 的主要目的是确保头文件只被包含一次。
当头文件被第一次包含时，#ifndef 中的条件为真，会定义宏 HEADER_FILE_NAME_H，然后将头文件的内容包含在 #endif 之前。在之后的包含中，由于宏已经被定义，条件为假，#ifndef 到 #endif 之间的代码块将被忽略，从而避免了重复定义。

举例说明：

假设有一个头文件 example.h：

// example.h

#ifndef EXAMPLE_H
#define EXAMPLE_H

// 头文件的内容

#endif // EXAMPLE_H

在其他文件中，可以这样使用：

#include "example.h"

// 在这里使用 example.h 中定义的内容

这样，即使在多个源文件中包含了同一个头文件，也不会导致重复定义的问题。