• <ins id="pjuwb"></ins>
    <blockquote id="pjuwb"><pre id="pjuwb"></pre></blockquote>
    <noscript id="pjuwb"></noscript>
          <sup id="pjuwb"><pre id="pjuwb"></pre></sup>
            <dd id="pjuwb"></dd>
            <abbr id="pjuwb"></abbr>

            小明思考

            高性能服務器端計算
            posts - 70, comments - 428, trackbacks - 0, articles - 0
              C++博客 :: 首頁 :: 新隨筆 :: 聯系 :: 聚合  :: 管理

            如何寫出專業的C頭文件

            Posted on 2007-05-15 13:38 小明 閱讀(10401) 評論(7)  編輯 收藏 引用 所屬分類: C/C++
             

            做到專業,應該是每個職業程序員應該要求自己做到的。
            讓我們看看lua是怎么寫頭文件的。

            1.License Agreement
            License Agreement
            應該加在每個頭文件的頂部。
            Lua Sample:

             

            /*
            ** $Id: lua.h,v 1.175b 2003/03/18 12:31:39 roberto Exp $
            ** Lua - An Extensible Extension Language
            ** Tecgraf: Computer Graphics Technology Group, PUC-Rio, Brazil
            ** 
            http://www.lua.org    mailto:info@lua.org
            ** See Copyright Notice at the end of this file
            */

             


            2.guard define
            整個頭文件應該在guard define之間

            #ifndef lua_h
            #define lua_h

            #endif

             另外,如果這個頭文件可能給c++使用,要加上

            #ifdef __cplusplus
            extern "C" {
            #endif
            /*The lines within extern "C" */



            #ifdef __cplusplus
            }
            #endif

             
            3.盡量不要在頭文件中暴露數據結構

            這樣可以用戶降低對你的實現的依賴,也減少了用戶的編譯時間

             

            typedef struct lua_State lua_State;
            LUA_API lua_State 
            *lua_open (void);
            LUA_API 
            void       lua_close (lua_State *L);

             可以看到雖然用戶會一直使用lua_State,但是并不知道lua_State的結構是什么

            從一個使用lua的例子程序可以看出:

             

            #include "lua.h"
            #include 
            "lauxlib.h"
            #include 
            "lualib.h"

             

            int main(int argc, char *argv[])
            {
                lua_State 
            *= lua_open();
                
            const char *buf = "var = 100";
                
            int var ;
                luaopen_base(L);
                luaopen_io(L);
                lua_dostring(L, buf);
                lua_getglobal(L, 
            "var");
                var 
            = lua_tonumber(L, -1);
                lua_close(L);
                
            return 0;
            }

             

            4.函數聲明前加XXX_API已利于拓展

             Lua的例子

            #ifndef LUA_API
            #define LUA_API              extern
            #endif

            LUA_API lua_State 
            *lua_open (void);


            如果定義了LUA_API就是給LUA內部使用的

            如果沒定義LUA_API就是for user

            Window dll程序經常會用到

             

            #ifdef DLLTEST_EXPORTS
            #define DLLTEST_API __declspec(dllexport)
            #else
            #define DLLTEST_API __declspec(dllimport)
            #endif

             

             

            5.宏的定義

            盡量使用括號來包住所定義的對象

             

            #define LUA_TNONE       (-1)

            #define lua_register(L,n,f) \
                   (lua_pushstring(L, n), \
                    lua_pushcfunction(L, f), \
                    lua_settable(L, LUA_GLOBALSINDEX))

             
            6.目錄結構

            一般應該使用一個單獨的include目錄來包含要發布的頭文件,但不應該把內部使用的頭文件包含進去。

            Lua   include目錄只包含了三個頭文件

            lauxlib.h , lua.h, lualib.h

            非常簡潔

            Feedback

            # re: 如何寫出專業的C頭文件  回復  更多評論   

            2007-05-17 11:49 by 丑石
            總結的不錯!

            # re: 如何寫出專業的C頭文件  回復  更多評論   

            2007-05-18 23:07 by Qiu Xianli
            值得學習一下。

            # re: 如何寫出專業的C頭文件  回復  更多評論   

            2007-09-01 22:48 by 螞蟻終結者
            不錯,學習了。

            # re: 如何寫出專業的C頭文件  回復  更多評論   

            2007-10-17 10:04 by 螞蟻終結者
            都是相當實用的,不錯。

            # re: 如何寫出專業的C頭文件  回復  更多評論   

            2008-01-23 16:41 by icqanki
            的確不錯.

            # re: 如何寫出專業的C頭文件  回復  更多評論   

            2008-07-03 18:23 by pantree
            謝謝了,不錯,啟發很多。最近正為這個頭疼

            # re: 如何寫出專業的C頭文件  回復  更多評論   

            2010-01-20 10:34 by xx
            支持,總結得不錯
            国产精品免费看久久久香蕉| 精品无码久久久久久尤物| 蜜桃麻豆www久久| 久久AⅤ人妻少妇嫩草影院| 久久影院久久香蕉国产线看观看| 久久亚洲精品无码播放| 亚洲精品国精品久久99热一| 久久精品无码专区免费东京热 | 99久久精品免费看国产一区二区三区| 精品无码久久久久国产动漫3d| AV色综合久久天堂AV色综合在| 久久精品亚洲福利| 久久人人爽人人爽人人AV| 精品无码久久久久久久动漫| 国产精品99久久久精品无码| 91久久精品国产成人久久| 久久久黄色大片| 99久久精品免费| 亚洲中文精品久久久久久不卡| 久久亚洲欧洲国产综合| 99精品久久精品一区二区| 亚洲欧美国产日韩综合久久| 国产69精品久久久久777| 伊人情人综合成人久久网小说| 精品久久久久久久久中文字幕| 久久久噜噜噜久久中文字幕色伊伊| 久久91亚洲人成电影网站| 亚洲精品蜜桃久久久久久| 久久黄视频| 国产精品综合久久第一页| 久久精品中文字幕久久| 人妻久久久一区二区三区| 久久香蕉国产线看观看精品yw| 久久久久久国产a免费观看黄色大片| 久久精品国产WWW456C0M| 国产成人精品久久亚洲高清不卡| 久久国产精品久久精品国产| 狠狠干狠狠久久| 热99re久久国超精品首页| 91精品国产色综久久 | 精品国产一区二区三区久久蜜臀|