编程技术是改变世界的力量。
本站
当前位置:网站首页 > 后端语言 > 正文

嵌入式C语言中的头文件设计(c语言头文件嵌套)

gowuye 2024-04-25 04:46 9 浏览 0 评论

C语言中的头文件,一般由四部分内容组成:

1、头文件的版权和版本声明。例如,

//*****************************************************************************

//版 权:软件归属

//文件名称:文件名

//说 明:用于详细说明此程序文件完成的主要功能

//作 者:作者

//版 本:版本

//完成日期:完成日期

//修改历史:修改历史记录列表,每条修改记录应包括修改日期、修改者及修改内容简述。

//*******************************************************************************

2、预处理块。例如,

#ifdef _DEBUG

#define STATIC static

#else

#define STATIC

#endif

3、函数、变量、结构声明。例如,

extern t_uint8 ReadAD(t_uint8 Channel);

4、宏、类型定义。

宏定义举例,

#ifndef true

#define true(1)

#endif

#ifndef false

#define false(0)

#endif

类型定义举例,

typedef unsigned chart_uint8;

typedef unsigned shortt_uint16;

typedef unsigned longt_uint32;

typedef unsigned long longt_uint64;

接下来,我们再来看一下,在写头文件的过程中,具体需要注意哪些问题。

头文件只能放置接口的声明,不能放置实现

头文件是模块的对外接口。头文件中应放置对外部的声明,如对外提供的函数声明、宏定义、类型定义等。内部使用的函数(这相当于C++类的私有方法)声明不应放在头文件中。内部使用的宏、枚举、结构定义也不应放入头文件中。

变量定义不应放在头文件中,而应放在.c文件中。变量的声明尽量不要放在头文件中,即尽量不要使用全局变量作为接口。

变量是模块的内部实现细节,不应通过头文件中声明的方式直接暴露给外部,而应通过函数接口的方式进行对外暴露。即使必须使用全局变量,也只应当在.c文件中定义全局变量,在.h文件中仅声明变量为全局的。关于全局变量的使用,我在上一篇文章里专门谈到过。

每一个.c文件应有一个同名.h文件,用于声明需要对外公开的接口

如果一个.c文件不需要对外公布任何接口,则其就不应当存在,除非它是程序的入口,如main函数所在的文件。每个工程中,一定有main.c,但是很少有main.h。

反过来,有.h文件但不一定有对应的.c文件。有些特别简单的头文件,如定义命令ID头的文件,就不需要有对应的.c存在。

禁止头文件循环依赖

头文件循环依赖,是指a.h包含b.h,b.h包含c.h,c.h包含a.h之类的操作,会导致任何一个头文件修改,都导致所有包含了a.h/b.h/c.h的代码全部重新编译一遍。而如果是单向依赖,如a.h包含b.h,b.h包含c.h,而c.h不包含任何头文件,则修改a.h不会导致包含了b.h和c.h的源代码重新编译。

一般的,文件包含的原则都是向下包含,上层包含下层,不允许下层包含上层。实际上,这就是下层对上层屏蔽细节,上层对下层不可见的原则的体现。这里又涉及到软件分层思想的建立,又是另一个话题,以后有机会再讨论。

防止头文件重复包含

为每个文件都配置一个宏,当头文件第一次被包含时就定义这个宏,并在头文件被再次包含时使用它以排除文件内容。

所有头文件都应当使用#define 防止头文件被多重包含,命名格式为

#ifndef FILENAME_H

#define FILENAME_H

#endif

禁止在.c中通过extern的方式使用外部函数接口和变量。

只能通过包含头文件的方式使用其他.c提供的接口,禁止在.c文件中通过extern的方式使用外部函数接口和变量。若a.c使用了b.c定义的fool()函数,则应当在b.h中声明

extern int fool(int input);

并在a.c 中通过

#include “b.h”

来使用fool函数。禁止通过在a.c中直接写extern int foo(intinput)来使用foo函数,因为后面这种写法容易在fool函数改变时,导致声明和定义的不一致,产生一些不必要的麻烦。如果在每个需要使用到fool函数.c文件里都添加函数声明的话,也不便于统一管理,甚至还增加一些不必要的冗余代码。

相关推荐

Nginx 响应提速10倍,你需要知道的缓存性能优化——FastCGI调优
Nginx 响应提速10倍,你需要知道的缓存性能优化——FastCGI调优

Nginx缓存优化是帮助大家提升网站性能的重要操作之一,proxy_cache主要用于反向代理时,对后端内容源服务器进行缓存;fastcgi_cache主要用于...

2024-05-20 14:44 gowuye

王者荣耀天魔缭乱和逐梦之音返场活动地址 3月22日开启返场活动
王者荣耀天魔缭乱和逐梦之音返场活动地址 3月22日开启返场活动

王者荣耀官方终于确定了天魔缭乱和逐梦之音的返场活动,这让不少小伙伴乐开了花,返场活动将会在3月22日开启,下面就带来王者荣耀天魔缭乱和逐梦之音返场活动地址!王者...

2024-05-20 14:44 gowuye

常见的嵌入式web服务器有哪些?

嵌入式WEB服务器常见的有:Lighttpd,Shttpd,Thttpd,Boa,Mini_httpd,Appweb,Goahead。Lighttpd地址:http://www.light...

简述几款常见的嵌入式web服务器
简述几款常见的嵌入式web服务器

嵌入式web服务器,是web服务器当中的一种,是基于嵌入式系统而实现的web服务器。指的是在嵌入式系统(通俗点就是单片机系统)上实现的一个web服务器,可以通过...

2024-05-20 14:44 gowuye

教你如何利用fastcgi_cache缓存加速WordPress

在使用nginx缓存之前,必须在nginx里面加载专门的模块,这个模块叫做ngx_cache_purge。添加ngx_cache_purge模块下载ngx_cache_purge模块ngx_cache...

扫描WordPress漏洞

检测已知漏洞WPScan是一款广泛使用的WordPress安全扫描工具,它的一项重要功能是检测已知漏洞。在这篇文章中,我们将深入探讨WPScan如何检测已知漏洞,并结合实际示例,帮助读者更好地理解和应...

消灭 Bug!推荐几个给力的开源 Bug 跟踪工具
消灭 Bug!推荐几个给力的开源 Bug 跟踪工具

在这个充满bug的世界里,最遥远的距离不是生与死,而是你亲手制造的bug就在你眼前,你却怎么都找不到它。因此本文准备了7款优秀的开源bug跟踪系...

2024-05-20 14:43 gowuye

生物信息分析入门全攻略

生物信息学是生命科学研究的重大前沿领域,未来将占据生命科学研究的半壁江山。已经有越来越多的小伙伴投入到生物信息的学习中,但是入门难、深入慢、摸不到方向等都成为持续学习的拦路虎。本文根据生物信息技术大牛...

elkb实践经验,再赠送一套复杂的配置文件
elkb实践经验,再赠送一套复杂的配置文件

原创:小姐姐味道(微信公众号ID:xjjdog),欢迎分享,转载请保留出处。宝剑锋从磨砺出,梅花香自苦寒来。诗人白居易,三月下江南,看到沿路开放的桃花,心潮澎湃...

2024-05-20 14:43 gowuye

超详细从0到1 搭建ELK监控
超详细从0到1 搭建ELK监控

监控分类?Metrics用于记录可聚合的数据。例如,1、队列的当前深度可被定义为一个度量值,在元素入队或出队时被更新;HTTP请求个数可被定义为一个计数器,...

2024-05-20 14:42 gowuye

嵌入式开发 之Web配置页面开发
嵌入式开发 之Web配置页面开发

1.PHP是最好的语言??开发动态页面首选的语言是PHP,村村不能在这里忽悠人,如果你的硬件性能允许切略懂PHP,看到这里就可以退出了。本文面向的受众是Linu...

2024-05-20 14:42 gowuye

Python开发一个网站目录扫描工具用来检测网站是否有漏洞?
Python开发一个网站目录扫描工具用来检测网站是否有漏洞?

开发一个网站目录扫描工具是用来检测网站是否有非法目录请求的一个常见需求之一,我们要通过这个扫描工具来找到通过某个域名可以访问到的网站路径,可能对于有些系统来讲,...

2024-05-20 14:42 gowuye

创建一个类似Youtube的Id——使用PHP/Python/JS/Java/SQL

id通常都是用数字,不巧的是只有10个数字来使用,所以如果你有很多的记录,id往往变得非常冗长。当然对于计算机来说无所谓,但我们更希望id尽可能短。所以我们如何能使id变短?我们可以利用字母让它们附加...

快速云:有助于移动应用安全开发的五条妙计
快速云:有助于移动应用安全开发的五条妙计

许多企业不断地向其开发团队提供培训。但是某些漏洞,如早在十多年前就发现的SQL注入,如今仍广泛存在于各种应用中。因而,安全培训永不过时。在开发移动应用时,开发者...

2024-05-20 14:41 gowuye

洛杉矶国际电影节最佳动画短片奖影片《G’DAY》正式全网上映
洛杉矶国际电影节最佳动画短片奖影片《G’DAY》正式全网上映

7月2日,由M&CSaatchi创作,由深受好评的澳大利亚导演迈克尔·格雷西执导的动画短片《G’day》,正式在全网上映。该影片因其出色的创意赢得了洛...

2024-05-20 14:41 gowuye

取消回复欢迎 发表评论: