Update README.md

优化叙述逻辑
This commit is contained in:
Jdhggg 2025-03-24 22:39:40 +08:00
parent fe663f1468
commit 2ae1f280b4

View File

@ -3,7 +3,44 @@
通过用C语言构建本学期所有数据结构和算法,来练编码.
## 项目结构说明
`main.c`由于测试和调用其它`.c`文件,其它算法源文件用其英文名命名,编写被调用文件时首先在`name.h`声名结构体和函数,然后在`name.c`实现功能.
## 示例
-[跳转到示例代码](#section2)
## 补充
### 知识补充
```c
#ifndef LINKED_LIST_H
#define LINKED_LIST_H
#endif
```
在 C 语言中,头文件(`.h` 文件)通常使用预处理指令 `#ifndef``#define``#endif` 来防止头文件被重复包含,避免编译错误。这种技术被称为 **头文件保护符****包含卫士**
**工作原理:**
1. **`#ifndef LINKED_LIST_H`**:检查宏 `LINKED_LIST_H` 是否未被定义。
2. **`#define LINKED_LIST_H`**:如果未定义,则定义宏 `LINKED_LIST_H`
3. **头文件内容**:包含实际的类型定义和函数声明。
4. **`#endif`**:结束条件编译。
当头文件第一次被包含时,`LINKED_LIST_H` 未被定义,编译器会处理头文件内容并定义 `LINKED_LIST_H`。如果头文件再次被包含,由于 `LINKED_LIST_H` 已被定义,`#ifndef` 条件不成立,编译器会跳过头文件内容,从而避免重复定义。
**注意事项:**
- **宏名的唯一性**:确保每个头文件的宏名唯一,通常使用头文件名的大写形式,并用下划线替代非字母数字字符。
- **`#pragma once` 指令**:一些编译器支持 `#pragma once`,它可以防止头文件被多次包含,使用起来更简洁,但并非所有编译器都支持,使用 `#ifndef` 等预处理指令具有更好的可移植性。
通过使用头文件保护符,可以有效防止头文件的重复包含,确保代码的正确编译。
### 规则补充
统一使用`小写下划线命名法`
## 示例代码 <a id="section2"></a>
`linked_list.h`:
```c
#ifndef LINKED_LIST_H
@ -128,32 +165,12 @@ int main() {
return 0;
}
```
## 补充
### 知识补充
```c
#ifndef LINKED_LIST_H
#define LINKED_LIST_H
#endif
### 文件结构
```tree
project/
├── (忽略)
├── README.md
├── linked_list.h
├── linked_list.c
└── main.c
```
在 C 语言中,头文件(`.h` 文件)通常使用预处理指令 `#ifndef``#define``#endif` 来防止头文件被重复包含,避免编译错误。这种技术被称为 **头文件保护符****包含卫士**
**工作原理:**
1. **`#ifndef LINKED_LIST_H`**:检查宏 `LINKED_LIST_H` 是否未被定义。
2. **`#define LINKED_LIST_H`**:如果未定义,则定义宏 `LINKED_LIST_H`
3. **头文件内容**:包含实际的类型定义和函数声明。
4. **`#endif`**:结束条件编译。
当头文件第一次被包含时,`LINKED_LIST_H` 未被定义,编译器会处理头文件内容并定义 `LINKED_LIST_H`。如果头文件再次被包含,由于 `LINKED_LIST_H` 已被定义,`#ifndef` 条件不成立,编译器会跳过头文件内容,从而避免重复定义。
**注意事项:**
- **宏名的唯一性**:确保每个头文件的宏名唯一,通常使用头文件名的大写形式,并用下划线替代非字母数字字符。
- **`#pragma once` 指令**:一些编译器支持 `#pragma once`,它可以防止头文件被多次包含,使用起来更简洁,但并非所有编译器都支持,使用 `#ifndef` 等预处理指令具有更好的可移植性。
通过使用头文件保护符,可以有效防止头文件的重复包含,确保代码的正确编译。
### 规则补充
统一使用`小写下划线命名法`