聲明：本文為轉載！文尾有作者聯系方式 。
先看一段代碼：

分析
　　顯然，頭文件中的編譯宏“#ifndef __INCvxWorksh、#define __INCvxWorksh、#endif” 的作用是防止該頭文件被重復引用。
?? 那么
的作用又是什么呢？

extern "C" 包含雙重含義，從字面上即可得到：首先，被它修飾的目標是“extern”的；其次，被它修飾的目標是“C”的。讓我們來詳細解讀這兩重含義。

　　被extern "C"限定的函數或變量是extern類型的；

　　extern是C/C++語言中表明函數和全局變量作用范圍（可見性）的關鍵字，該關鍵字告訴編譯器，其聲明的函數和變量可以在本模塊或其它模塊中使用。記住，下列語句：
僅僅是一個變量的聲明，其并不是在定義變量a，并未為a分配內存空間。變量a在所有模塊中作為一種全局變量只能被定義一次，否則會出現連接錯誤。

　　通常，在模塊的頭文件中對本模塊提供給其它模塊引用的函數和全局變量以關鍵字extern聲明。例如，如果模塊B欲引用該模塊A中定義的全局變量和函數時只需包含模塊A的頭文件即可。這樣，模塊B中調用模塊A中的函數時，在編譯階段，模塊B雖然找不到該函數，但是并不會報錯；它會在連接階段中從模塊A編譯生成的目標代碼中找到此函數。

　　與extern對應的關鍵字是static，被它修飾的全局變量和函數只能在本模塊中使用。因此，一個函數或變量只可能被本模塊使用時，其不可能被extern “C”修飾。

　　被extern "C"修飾的變量和函數是按照C語言方式編譯和連接的；

未加extern “C”聲明時的編譯方式

首先看看C++中對類似C的函數是怎樣編譯的。

　　作為一種面向對象的語言，C++支持函數重載，而過程式語言C則不支持。函數被C++編譯后在符號庫中的名字與C語言的不同。例如，假設某個函數的原型為：
該函數被C編譯器編譯后在符號庫中的名字為_foo，而C++編譯器則會產生像_foo_int_int之類的名字（不同的編譯器可能生成的名字不同，但是都采用了相同的機制，生成的新名字稱為“mangled name”）。

　　_foo_int_int這樣的名字包含了函數名、函數參數數量及類型信息，C++就是靠這種機制來實現函數重載的。例如，在C++中，函數void foo( int x, int y )與void foo( int x, float y )編譯生成的符號是不相同的，后者為_foo_int_float。

??????? 同樣地，C++中的變量除支持局部變量外，還支持類成員變量和全局變量。用戶所編寫程序的類成員變量可能與全局變量同名，我們以"."來區分。而本質上，編譯器在進行編譯時，與函數的處理相似，也為類中的變量取了一個獨一無二的名字，這個名字與用戶程序中同名的全局變量名字不同。
?????
???? 未加extern "C"聲明時的連接方式
假設在C++中，模塊A的頭文件如下：
在模塊B中引用該函數：
實際上，在連接階段，連接器會從模塊A生成的目標文件moduleA.obj中尋找_foo_int_int這樣的符號！

　　加extern "C"聲明后的編譯和連接方式

　　加extern "C"聲明后，模塊A的頭文件變為：
在模塊B的實現文件中仍然調用foo( 2,3 )，其結果是：

　?。?）模塊A編譯生成foo的目標代碼時，沒有對其名字進行特殊處理，采用了C語言的方式；

　　（2）連接器在為模塊B的目標代碼尋找foo(2,3)調用時，尋找的是未經修改的符號名_foo。

　　如果在模塊A中函數聲明了foo為extern "C"類型，而模塊B中包含的是extern int foo( int x, int y ) ，則模塊B找不到模塊A中的函數；反之亦然。

　　所以，可以用一句話概括extern “C”這個聲明的真實目的（任何語言中的任何語法特性的誕生都不是隨意而為的，來源于真實世界的需求驅動。我們在思考問題時，不能只停留在這個語言是怎么做的，還要問一問它為什么要這么做，動機是什么，這樣我們可以更深入地理解許多問題）：
　　實現C++與C及其它語言的混合編程。
　　明白了C++中extern "C"的設立動機，我們下面來具體分析extern "C"通常的使用技巧。
extern "C"的慣用法

　?。?）在C++中引用C語言中的函數和變量，在包含C語言頭文件（假設為cExample.h）時，需進行下列處理：
而在C語言的頭文件中，對其外部函數只能指定為extern類型，C語言中不支持extern "C"聲明，在.c文件中包含了extern "C"時會出現編譯語法錯誤。

　　筆者編寫的C++引用C函數例子工程中包含的三個文件的源代碼如下：
如果C++調用一個C語言編寫的.DLL時，當包括.DLL的頭文件或聲明接口函數時，應加extern "C" {　}。

　?。?）在C中引用C++語言中的函數和變量時，C++的頭文件需添加extern "C"，但是在C語言中不能直接引用聲明了extern "C"的該頭文件，應該僅將C文件中將C++中定義的extern "C"函數聲明為extern類型。
　　筆者編寫的C引用C++函數例子工程中包含的三個文件的源代碼如下：
如果深入理解了第3節中所闡述的extern "C"在編譯和連接階段發揮的作用，就能真正理解本節所闡述的從C++引用C函數和C引用C++函數的慣用法。對第4節給出的示例代碼，需要特別留意各個細節。

　　歡迎與作者聯系溝通。聯系方式：
　　Email: 21cnbao@21cn.com
　　MSN: barrysong80@hotmail.com

制作一份eMule文檔，對學習eMule源代碼大有幫助！提供交叉引用，
文件名：index.chm 由于博客每次只能上傳最多2M，壓縮成四分卷，下載后把四部分放到同一個目錄下，用壓winRar解壓即可。
下載地址：
index.part1.rar

index.part2.rar

index.part3.rar

index.part4.rar

有什么問題，請朋友留言！謝！

前幾篇文章也提到過，ACE的所有源文件和頭文件都雜亂堆在了ACE_wrappers/ace目錄下。這樣的代碼組織方式給學習ACE帶來了很大的困難，很多朋友在看到ace目錄下龐大的代碼的時候，幾乎就失去了學習ACE的信心^_^。因此，我們有必要對ACE的代碼進行重新組織，以降低學習曲線。下面，我將給出我對ACE源碼的劃分方法。其實，我也是剛學習ACE沒有多久，對ACE的了解還甚少，所以，我的源碼劃方式法不一定十分正確，這里共享出來，僅供大家參考。

其實，在ACE的幫助文檔里，ACE-subsets.html和ACE-categories.html，這兩個文檔對指導ACE的源碼劃分起到了很大的作用，否則，我剛剛接觸ACE，就想對其進行源碼劃分，是不可能完成的。ACE-subsets.html，這個文檔主要介紹了ACE的library subsetting。正常情況下，在編譯完ACE后，只會產生一個ACE的庫。我們可以根據該文檔的介紹，簡單的修改一下Makefile，就可以對ACE的庫進行子集化，我們可以編譯出OS、Thread等這樣的子庫。ACE-categories.html，這個文檔對ACE中的代碼進行了一些功能上的分類。具體大家可以詳細的參考一下這兩個文檔，這兩個文檔對學習ACE還是有一定的幫助的。

在ACE的源代碼目錄ace下，我將建立很多子目錄，來對ACE的代碼進行按功能分類：

ACE_OS：該目錄里包含的代碼是OS的API的wrapper，也就是ACE的OS適配層；
 包含代碼： ARGV.cpp         OS_Memory.cpp
  Argv_Type_Converter.cpp    OS_QoS.cpp
  Base_Thread_Adapter.cpp    OS_String.cpp
  Basic_Types.cpp            OS_TLI.cpp
  Copy_Disabled.cpp          OS_Thread_Adapter.cpp
  Env_Value_T.cpp            Sched_Params.cpp
  Handle_Set.cpp        Template_Instantiations.cpp
  Makefile                   Thread_Hook.cpp
  OS.cpp                     Time_Value.cpp
  OS_Dirent.cpp                
  OS_Errno.cpp                 
  OS_Log_Msg_Attributes.cpp

ACE_Codec：該目錄包含的是ACE的各種編碼類型的處理代碼，目前只包含了BASE64編碼的處理；
    包含代碼：Codecs.cpp   Makefile

ACE_Connection：該目錄包含的是ACE中的Acceptor-Connector框架代碼和異步通訊類代碼；
  包含代碼：Acceptor.cpp           Connector.cpp
   Asynch_Acceptor.cpp             Makefile
   Asynch_Connector.cpp        POSIX_Asynch_IO.cpp
   Asynch_IO.cpp                   Strategies_T.cpp
   Asynch_IO_Impl.cpp              Svc_Handler.cpp
   Asynch_Pseudo_Task.cpp      WIN32_Asynch_IO.cpp
   Cached_Connect_Strategy_T.cpp  
   Caching_Strategies_T.cpp       

ACE_Demux：該目錄包含的是ACE中的Reactor和Proactor框架代碼；
    包含代碼：Dev_Poll_Reactor.cpp     Priority_Reactor.cpp      TP_Reactor.cpp        Event_Handler.cpp         Proactor.cpp              TkReactor.cpp
  Event_Handler_T.cpp       QtReactor.cpp             WFMO_Reactor.cpp
  FlReactor.cpp            Reactor.cpp               WIN32_Proactor.cpp
  Makefile                  SUN_Proactor.cpp          XtReactor.cpp
  Msg_WFMO_Reactor.cpp      Select_Reactor.cpp       
  POSIX_CB_Proactor.cpp     Select_Reactor_Base.cpp  
  POSIX_Proactor.cpp        Select_Reactor_T.cpp

ACE_IPC：該目錄包含的是ACE中進程間通訊的一些封裝代碼：
  包含代碼：ATM_Acceptor.cpp             Makefile
  ATM_Addr.cpp                 Pipe.cpp
  ATM_Connector.cpp            SPIPE.cpp
  ATM_Params.cpp               SPIPE_Acceptor.cpp
  ATM_QoS.cpp                  SPIPE_Addr.cpp
  ATM_Stream.cpp               SPIPE_Connector.cpp
  DEV.cpp                      SPIPE_Stream.cpp
  DEV_Addr.cpp                 SV_Message.cpp
  DEV_Connector.cpp            SV_Message_Queue.cpp
  DEV_IO.cpp                   SV_Semaphore_Complex.cpp
  FIFO.cpp                     SV_Semaphore_Simple.cpp
  FIFO_Recv.cpp                SV_Shared_Memory.cpp
  FIFO_Recv_Msg.cpp            Signal.cpp
  FIFO_Send.cpp                TLI.cpp
  FIFO_Send_Msg.cpp            TLI_Acceptor.cpp
  FILE.cpp                     TLI_Connector.cpp
  FILE_Addr.cpp                TLI_Stream.cpp
  FILE_Connector.cpp           TTY_IO.cpp
  FILE_IO.cpp                  Typed_SV_Message.cpp
  IOStream.cpp                 Typed_SV_Message_Queue.cpp
  IOStream_T.cpp               UNIX_Addr.cpp
  IO_SAP.cpp                   UPIPE_Acceptor.cpp
  MEM_Acceptor.cpp             UPIPE_Connector.cpp
  MEM_Addr.cpp                 UPIPE_Stream.cpp
  MEM_Connector.cpp            XTI_ATM_Mcast.cpp
  MEM_IO.cpp                  
  MEM_SAP.cpp                 
  MEM_Stream.cpp

ACE_LIB：該目錄將包含ACE編譯好的各個子庫；

ACE_Logging：該目錄包含ACE中的日志處理相關代碼；
       包含代碼：Dump.cpp                   Log_Msg_UNIX_Syslog.cpp
  Dump_T.cpp                 Log_Record.cpp
  Log_Msg.cpp                Logging_Strategy.cpp
  Log_Msg_Backend.cpp        Makefile
  Log_Msg_Callback.cpp       Trace.cpp
  Log_Msg_IPC.cpp           
  Log_Msg_NT_Event_Log.cpp  

ACE_Memory：該目錄包含了ACE內存處理相關代碼；
     包含代碼：Based_Pointer_Repository.cpp   Obstack.cpp
  Based_Pointer_T.cpp            Obstack_T.cpp
  Makefile                       PI_Malloc.cpp
  Malloc.cpp                     Read_Buffer.cpp
  Malloc_Allocator.cpp           Shared_Memory.cpp
  Malloc_Instantiations.cpp      Shared_Memory_MM.cpp
  Malloc_T.cpp                   Shared_Memory_SV.cpp
  Mem_Map.cpp                   
  Memory_Pool.cpp               
  Obchunk.cpp

ACE_Misc：ACE中一些沒有明確功能分類的代碼，屬于雜項；
   包含代碼：CE_Screen_Output.cpp   NT_Service.cpp
  Makefile               gethrtime.cpp

ACE_Nameservices：該目錄包含了ACE中名字服務相關代碼；
    包含代碼： Name_Space.cpp
   Local_Name_Space.cpp           Naming_Context.cpp
   Local_Name_Space_T.cpp         Registry_Name_Space.cpp
   Makefile                       Remote_Name_Space.cpp
   Name_Proxy.cpp                
   Name_Request_Reply.cpp        

ACE_Sockets：該目錄包含的是ACE的socket封裝代碼；
      包含代碼：Addr.cpp                       SOCK_CODgram.cpp
  INET_Addr.cpp                  SOCK_Connector.cpp
  IPC_SAP.cpp                    SOCK_Dgram.cpp
  LOCK_SOCK_Acceptor.cpp         SOCK_Dgram_Bcast.cpp
  LSOCK.cpp                      SOCK_Dgram_Mcast.cpp
  LSOCK_Acceptor.cpp             SOCK_IO.cpp
  LSOCK_CODgram.cpp              SOCK_SEQPACK_Acceptor.cpp
  LSOCK_Connector.cpp            SOCK_SEQPACK_Association.cpp
  LSOCK_Dgram.cpp                SOCK_SEQPACK_Connector.cpp
  LSOCK_Stream.cpp               SOCK_Stream.cpp
  Makefile                       Sock_Connect.cpp
  Multihomed_INET_Addr.cpp      
  SOCK.cpp                      
  SOCK_Acceptor.cpp

ACE_Streams：該目錄包含了ACE中的Streams和Task框架代碼；
      包含代碼：CDR_Base.cpp                        Module.cpp
  CDR_Stream.cpp                      Multiplexor.cpp
  Codeset_IBM1047.cpp                 Reactor_Notification_Strategy.cpp
  Codeset_Registry.cpp                Stream.cpp
  Codeset_Registry_db.cpp             Stream_Modules.cpp
  IO_Cntl_Msg.cpp                     Task.cpp
  Makefile                            Task_T.cpp
  Message_Queue.cpp                  
  Message_Queue_T.cpp   

ACE_Svcconf：該目錄包含了ACE中的Service Configurator框架代碼；
      包含代碼：DLL.cpp                    Service_Types.cpp
  DLL_Manager.cpp            Shared_Object.cpp
  Dynamic_Service.cpp        Svc_Conf.l
  Dynamic_Service_Base.cpp   Svc_Conf.y
  Makefile                   Svc_Conf_Lexer_Guard.cpp
  Parse_Node.cpp             Svc_Conf_l.cpp
  Service_Config.cpp         Svc_Conf_y.cpp
  Service_Manager.cpp        XML_Svc_Conf.cpp
  Service_Object.cpp        
  Service_Repository.cpp    
  Service_Templates.cpp

ACE_Threads：該目錄包含了ACE中的線程和同步機制相關代碼，例如：thread manager;
      包含代碼：Activation_Queue.cpp      Process_Manager.cpp       Thread.cpp
  Atomic_Op.cpp             Process_Mutex.cpp         Thread_Adapter.cpp
  Atomic_Op_T.cpp           Process_Semaphore.cpp     Thread_Control.cpp
  File_Lock.cpp             RW_Process_Mutex.cpp      Thread_Exit.cpp
  Future.cpp                Synch.cpp                 Thread_Manager.cpp
  Future_Set.cpp            Synch_Options.cpp         Token.cpp
  Makefile                  Synch_T.cpp              
  Process.cpp               Test_and_Set.cpp         

ACE_Timer：該目錄包含ACE中和時間相關的代碼；
     包含代碼：Timer_Heap.cpp
  Basic_Stats.cpp            Timer_Heap_T.cpp
  High_Res_Timer.cpp         Timer_List.cpp
  Makefile                   Timer_List_T.cpp
  Profile_Timer.cpp          Timer_Queue.cpp
  System_Time.cpp            Timer_Queue_Adapters.cpp
  Time_Request_Reply.cpp     Timer_Queue_T.cpp
  Timeprobe.cpp              Timer_Wheel.cpp
  Timeprobe_T.cpp            Timer_Wheel_T.cpp
  Timer_Hash.cpp            
  Timer_Hash_T.cpp          

ACE_Token：Token是ACE中實現的一種同步機制，保證嚴格的FIFO或LIFO策略來獲得鎖。ACE通過Token機制實現了分布式同步機制。
     包含代碼：Local_Tokens.cpp          Token_Collection.cpp      Token_Request_Reply.cpp
  Makefile                  Token_Invariants.cpp     
  Remote_Tokens.cpp         Token_Manager.cpp        

ACE_Utils：ACE中的一些基礎數據結構和算法的工具類代碼；
    包含代碼：ACE.cpp                             Init_ACE.cpp
  Active_Map_Manager.cpp              Intrusive_List.cpp
  Active_Map_Manager_T.cpp            Intrusive_List_Node.cpp
  Arg_Shifter.cpp                     Lib_Find.cpp
  Array_Base.cpp                      Makefile
  Auto_IncDec_T.cpp                   Managed_Object.cpp
  Auto_Ptr.cpp                        Map.cpp
  Cache_Map_Manager_T.cpp             Map_Manager.cpp
  Caching_Utility_T.cpp               Map_T.cpp
  Capabilities.cpp                    Message_Block.cpp
  Cleanup_Strategies_T.cpp            Message_Block_T.cpp
  Configuration.cpp                   Method_Request.cpp
  Configuration_Import_Export.cpp     Node.cpp
  Connection_Recycling_Strategy.cpp   Notification_Strategy.cpp
  Containers.cpp                      Object_Manager.cpp
  Containers_T.cpp                    Pair.cpp
  Date_Time.cpp                       Pair_T.cpp
  Dirent.cpp                          RB_Tree.cpp
  Dirent_Selector.cpp                 Recyclable.cpp
  Dynamic.cpp                         Refcountable.cpp
  Filecache.cpp                       Registry.cpp
  Flag_Manip.cpp                      SString.cpp
  Framework_Component.cpp             Sample_History.cpp
  Framework_Component_T.cpp           Singleton.cpp
  Free_List.cpp                       Stats.cpp
  Functor.cpp                         String_Base.cpp
  Functor_T.cpp                       String_Base_Const.cpp
  Get_Opt.cpp                         Swap.cpp
  Handle_Ops.cpp                      Unbounded_Queue.cpp
  Hash_Cache_Map_Manager_T.cpp        Unbounded_Set.cpp
  Hash_Map_Manager.cpp                Unbounded_Set_Ex.cpp
  Hash_Map_Manager_T.cpp              Vector_T.cpp
  Hash_Map_With_Allocator_T.cpp      
  Hashable.cpp                       

include：該目錄又包含子目錄ace，也就是說include/ace/目錄下，包含了ACE的所有頭文件和.i文件，之所以這樣組織，是因為            

通過上面給出的目錄結構和源文件功能劃分及頭文件組織方式，相信讀者以可以自行對ACE代碼進行整理了。在實際整理和編譯代碼的過程中，需要修改Makefile和ACE頭文件中以_T方式為后綴的頭文件，例如：Obstack_T.h，需要修改里面模板源文件包含路徑。我將在下一篇文章中進行描述。

我再次強調，上面ACE源碼劃分方式，不一定十分正確^_^，隨著我們ACE學習和理解的深入，我們可能會進行更改。其實，在我們整理ACE源文件的時候，我們可以進一步了解ACE的各個源文件大致功能，對我們以后更深入的學習大有裨益。

致力于C/C++開發,致力于標準庫,跨平臺應用,致力于STL,ACE解決問題,致力于P2P網絡領域研究!