文章目錄

• 一、頭文件定義
• • 1、頭文件導入限制
  • 2、兼容 C++ 語言
  • 3、函數形參輸入輸出屬性
  • 4、代碼示例

一、頭文件定義

---

1、頭文件導入限制

頭文件導入限制 : 防止頭文件多次導入 , 將頭文件的內容 , 使用下面的宏定義包裹 ;

// 防止多次導入 #ifndef __CFG_H__ #define __CFG_H__#endif // __CFG_H__

2、兼容 C++ 語言

兼容 C++ 語言 : 為了使該頭文件既可以在 C 語言中使用 , 又可以在 C++ 中使用 , 使用如下宏定義 包裹 頭文件內容 ;

// 兼容 C++ #ifdef __cplusplus extern "C" { #endif // __cplusplus#ifdef __cplusplus } #endif // __cplusplus

3、函數形參輸入輸出屬性

如果函數形參 作為輸入 , 可以在形參名很后面添加 /*in*/ 注釋 ;

如果函數形參 作為輸出 , 可以在形參名很后面添加 /*out*/ 注釋 ;

如果函數形參 即作為輸入 , 又作為輸出 , 可以在形參名很后面添加 /*in out*/ 注釋 ;

這個注釋沒有實際的意義 , 本質是普通注釋 , 但是可以增加代碼的可讀性 ;

// 獲取配置項 int read_config_file(char *filename /*in*/, char *key /*in*/, char * value/*in out*/, int * value_len /*out*/);

4、代碼示例

頭文件代碼示例 :

// 防止多次導入 #ifndef __CFG_H__ #define __CFG_H__// 兼容 C++ #ifdef __cplusplus extern "C" { #endif // __cplusplus// 定義接口時 , 如果函數形參用作輸入數據時 , 可以在形參名很后面添加 /*in*/ 注釋 //// 獲取配置項 int read_config_file(char *filename /*in*/, char *key /*in*/, char * value/*in out*/, int * value_len /*out*/);// 寫出 / 更新配置項 int write_or_update_config_file(char *filename /*in*/, char *key /*in*/, char *value/*in*/, int value_len /*in*/);#ifdef __cplusplus } #endif // __cplusplus#endif // __CFG_H__

總結

以上是生活随笔為你收集整理的【C 语言】文件操作 ( 配置文件读写 | 框架搭建 | 头文件定义 | 头文件导入限制 | 兼容 C++ 语言 | 函数形参输入输出属性注释)的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。