開源庫中的版權宣告注釋格式(Osip)

2021-08-13 22:07:34 字數 2234 閱讀 6963

李國帥 編於2006-7-10 14:22

1、標頭檔案osip_accept.h

/*

*/#ifndef _osip_accept_h_------------------------------------唯一性標示

#define _osip_accept_h_#include

----------包含的其他標頭檔案/**

* @file osip_accept.h--------------------------------------頭檔名稱

* @brief osip osip_accept header definition.---------------標頭檔案說明

*//*

** @defgroup osip_accept osip accept header definition.-----定義巨集

* @ingroup osip_headers------------------------------------包含關係

* @#endif

/** @}

*/#endif

2、定義檔案

/*

版權說明

*/#include

//------------系統標頭檔案

#include #include

//---------自定義標頭檔案

/*returns the content_type header as a string.

*///

------------函式功能

/*input : osip_content_type_t *content_type | content_type header.

*///

------------------------------應該輸入那些引數

/*returns null on error.

*///

-------- - 返回值含義

int osip_accept_to_str(const osip_accept_t * accept, char **dest)

/*try to guess a long enough length

*///

----------- 段落注釋

len = strlen(accept->type) + strlen(accept->subtype) + 4

/*for '/', ' ', ';' and '\0'

*///

------------------行注釋

+ 10 * osip_list_size(accept->gen_params);

buf = (char *)osip_malloc(len); //

----------------所有的指標必須有其空間

tmp =buf;

sprintf(tmp,

"%s/%s

", accept->type, accept->subtype);

tmp = tmp +strlen(tmp);

#endif

while (!osip_list_eol(accept->gen_params, pos))

tmp_len = strlen(buf) + 4 + strlen(u_param->gname)

+ strlen(u_param->gvalue) + 1

;

if (len sprintf(tmp,

"; %s=%s

", u_param->gname, u_param->gvalue);

tmp = tmp +strlen(tmp);

pos++;}}

*dest =buf;

return0;

}

* 檔名稱:filename.h

* 檔案標識:見配置管理計畫書

* 當前版本:1.1

* 作 者:輸入作者(或修改者)名字

* 完成日期:2023年7月20日

* 取代版本:1.0

* 原作者 :輸入原作者(或修改者)名字

* 完成日期:2023年5月10日

附件2:精簡格式

實際的檔案不太需要這麼多,並且參照其他分成兩部分,版權說明和檔案說明

* 作 者:peter

* 檔名稱:

* 完成日期:2023年7月7日

* 摘 要:

Python 中os庫的使用

os庫提供通用的 基本的作業系統的互動功能 路徑操作 os.path字型檔,處理檔案路徑及資訊 程序管理 啟動系統中其他程式 環境引數 獲得系統軟硬體資訊等環境引數 os.path子庫以path為入口,用於操作和處理檔案路徑 import os.path as op os.path.abspath ...

python中OS庫的使用

os.path子庫路徑操作函式函式 描述os.path.abspath path 返回path在當前系統中的絕對路徑。os.path.abspath readme.txt 輸出 e web學習 readme.txt os.path.normpath path 歸一化path的表現形式,統一用 分隔路...

Python中os庫的基本使用

os庫的基本使用 os庫基本介紹 os庫提供通用的 基本的作業系統互動功能 包括 windows mac os linux os庫是python標準庫,包含幾百個函式 常用路徑操作 程序管理 環境引數等幾類 路徑操作 os.path子庫,處理檔案路徑及資訊 程序管理 啟動系統中其他程式 環境引數 獲...