【C语言 - 简易架构】

对于很多半路出家的程序员来说，很多基础的事情反而不知道怎么办。类似全局变量、局部变量、函数声明、函数定义之类的。

一、头文件（.h文件）的作用

头文件在C语言中扮演着至关重要的角色，它们主要用于声明函数、宏定义、类型定义和全局变量，以便在多个源文件中共享这些声明。以下是头文件中常见的内容：

1.1 宏定义

宏定义用于在编译时替换代码中的文本，常用于条件编译和常量定义。

1.2 类型定义

自定义类型可以通过typedef在头文件中定义，以提高代码的可读性和可维护性。

1.3 函数声明

头文件中通常会包含函数的声明，这样其他源文件就可以在不包含函数实现的情况下调用这些函数。

1.4 外部变量声明

虽然全局变量的声明可以放在头文件中，但通常不推荐这样做，因为这会导致变量在多个文件中被定义，从而引发链接错误。

c 复制代码

// example.h
#ifndef EXAMPLE_H
#define EXAMPLE_H

/******************************************************************************
* #define
******************************************************************************/
#define AAA 1
/******************************************************************************
* typedef structs & unions & enums
******************************************************************************/
typedef enum
{
  ENUM_A = 0,
  ENUM_B = 1,
  ENUM_C = 2
} E_Type;
typedef struct									  
{
    int8                  exampleVa;
    int *                 examplePo; 
}EXAMPLE_PACKAGE;
/******************************************************************************
* Function prototypes. Physically declared in c-file
******************************************************************************/
void exampleFunction(void);

/******************************************************************************
* extern declarated data. Physically declared in c-file
******************************************************************************/
extern int Example_A;

#endif

二、变量定义的位置

在C语言中，变量的定义位置是一个需要仔细考虑的问题。

2.1 全局变量

全局变量应该定义在.c文件中，并且在.h文件中使用extern关键字声明，以避免在多个文件中重复定义。

2.2 静态全局变量

如果全局变量只在单个文件中使用，可以将其定义为静态的，以限制其作用域。

2.3 局部变量

局部变量应该定义在函数内部，它们的作用域仅限于定义它们的函数。

c 复制代码

// example.c
/********************  Dependent Include files here **********************/
#include "example.h"

/******************************************************************************
 * Global data declarations external declared in h-file
 ******************************************************************************/
int Example_A = 10;
/*----------------------------------------------------------------------------*/
/* Static Global Variables */
/*----------------------------------------------------------------------------*/
static int staticVar = 20;

/******************************************************************************
 * Global functions external declared in h-file
 ******************************************************************************/
 void exampleFunction(void)
 {
 /* local varialble */
 int localVar = 30;
 if()
 {}
 }

三、结构化编程的最佳实践

3.1 模块化

将程序分解成模块，每个模块负责特定的功能，并通过头文件和源文件来组织。

3.2 封装

使用函数和数据结构来封装实现细节，只通过头文件暴露必要的接口。

3.3 代码复用

通过头文件共享函数和宏定义，减少代码重复，提高复用性。

3.4 可维护性

合理组织代码结构，使得代码易于理解和维护。

通过遵循这些实践，C语言程序的架构将更加清晰，代码的质量和开发效率也将得到提升。在设计C语言程序时，开发者应该始终考虑到程序的可读性、可维护性和扩展性，以构建健壮和高效的软件系统。