在DocX中寫過載函式的幫助

2021-04-16 12:36:21 字數 1060 閱讀 4322

許式偉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類...