在DocX中寫過載函式的幫助

許式偉2006-12-23

今天，我發布了docx的乙個重要公升級。這個公升級主要解決了一直以來困擾我很久的函式過載（function overload）問題。

原先，docx只支援在主題文件（.man檔案）中書寫同名函式的幫助，而.h/.cpp等中無法做到。但是主題文件是我準備逐步淘汰的寫法。為此我設想過多種解決方案，但是都是因為需要對目前的程式做重大調整而作罷（由於本身屬於探索性質的，而且寫docx那會我剛好對模板特別熱衷，我認為過於技術化了。docx重構是遲早的事）。

今天收到wang carl先生的一封信，在信中，他給docx提了一些寶貴的意見，並且發了他寫的乙個有問題的docx樣例給我。在其中，他用到了docx目前並不支援的語法。

他這個樣例給了我很大的啟發，我馬上意識到，他給了我乙個可以解決困擾我很久的函式過載問題的方案。我馬上動手，把他寫的語法給支援了。

大體的文法如下：

/*@fn setuserinput(string)

@brief

設定使用者輸入

@arg [in] input

string, the expression of the user input@*/

void

setuserinput(

string

input);

/*@fn setuserinput(lpcstr)

@brief

設定使用者輸入

@arg [in] input

string, the expression of the user input@*/

void

setuserinput(lpcstr input);

同時，建構函式也支援過載：

/*@class input

@brief

用於可程式設計計算器的表式達處理@*/

class

input;

為了表示我的感謝，我把wang carl先生發給我的樣例也附到發布包中作為樣例提供了。參見：

關於docx的一些背景，請參考：

在DocX中寫過載函式的幫助

許式偉2006 12 23 今天，我發布了docx的乙個重要公升級。這個公升級主要解決了一直以來困擾我很久的函式過載 function overload 問題。原先，docx只支援在主題文件 man檔案 中書寫同名函式的幫助，而.h cpp等中無法做到。但是主題文件是我準備逐步淘汰的寫法。為此我設想...

DocX在C 中的基本操作方法

用了乙個星期把園子裡2016年中有關.net的文章都看了，有些只是大致的看了一下，在看的同時也在記錄一些通用的方法。發現有很多對npoi的文件，主要是操作excl的方法，卻很少有關文件型別的方法。在專案開發中，一般需要對文件進行操作，但是使用微軟提供的外掛程式，需要安裝一些程式，並且如果使用wps類...

DocX在C 中的基本操作方法

用了乙個星期把園子裡2016年中有關.net的文章都看了，有些只是大致的看了一下，在看的同時也在記錄一些通用的方法。發現有很多對npoi的文件，主要是操作excl的方法，卻很少有關文件型別的方法。在專案開發中，一般需要對文件進行操作，但是使用微軟提供的外掛程式，需要安裝一些程式，並且如果使用wps類...