僅僅為了擷取函數名,就在函數體中嵌入硬式編碼字串,這種方法單調乏味還易導致錯誤,不如看一下怎樣使用新的C99特性,在程式運行時擷取函數名吧。
對象反射庫、調試工具及程式碼分析器,經常會需要在運行時訪問函數的名稱,直到不久前,唯一能完成此項任務並且可移植的方法,是手工在函數體內嵌入一個帶有該函數名的寫入程式碼字串,不必說,這種方法非常單調無奇,並且輕易導致錯誤。本文將要示範怎樣使用新的C99特性,在運行時擷取函數名。
那麼怎樣以編程的方式從當前啟動並執行函數中得到函數名呢?
答案是:使用__FUNCTION__ 及相關宏。
引出問題
通常,在調試中最讓人心煩的階段,是不斷地檢查是否已調用了特定的函數。對此問題的解決方案,一般是添加一個cout或PRintf()——假如你使用C語言,如下所示:
void myfunc()
{
cout<<"myfunc()"<<endl;
//其他代碼
}
通常在一個典型的工程中,會包含有數千個函數,要在每個函數中都加入一條這樣的輸出語句,無疑難過上“蜀山”啊,因此,需要有一種機制,可以自動地完成這項操作。
擷取函數名
作為一個C++程式員,可能經常碰到 __TIME__、__FILE__、__DATE__ 這樣的宏,它們會在編譯時間,分別轉換為包含編譯時間、處理的轉換單元名稱及目前時間的字串。
在最新的ISO C標準中,如大家所知的C99,加入了另一個有用的、類似宏的運算式__func__,其會報告未修飾過的(也就是未裁剪過的)、正在被訪問的函數名。請注重,__func__不是一個宏,因為前置處理器對此函數一無所知;相反,它是作為一個隱式聲明的常量字元數組實現的:
static const char __func__[] = "function-name";
在function-name處,為實際的函數名。為啟用此特性,某些編譯器需要使用特定的編譯標誌,請查看相應的編譯器文檔,以擷取具體的資料。
有了它,我們可免去大多數通過手工修改,來顯示函數名的苦差事,以上的例子可如下所示進行重寫:
void myfunc()
{
cout<<"__FUNCTION__"<<endl;
}
官方C99標準為此目的定義的__func__標識符,確實值得大家關注,然而,ISO C++卻不完全支援所有的C99擴充,因此,大多數的編譯器供應商都使用 __FUNCTION__ 取而代之,而 __FUNCTION__ 通常是一個定義為 __func__ 的宏,之所以使用這個名字,是因為它已受到了大多數的廣泛支援。
在Visual Studio 2005中,預設情況下,此特性是啟用的,但不能與/EP和/P編譯選項同時使用。請注重在IDE環境中,不能識別__func__ ,而要用__FUNCTION__ 代替。
Comeau的使用者也應使用 __FUNCTION__ ,而不是 __func__ 。
C++ BuilderX的使用者則應使用稍稍不同的名字:__FUNC__ 。
GCC 3.0及更高的版本同時支援 __func__ 和__FUNCTION__ 。
一旦可自動擷取當前函數名,你可以定義一個如下所示顯示任何函數名的函數:
void show_name(const char * name)
{
cout<<name<<endl;
}
void myfunc()
{
show_name(__FUNCTION__); //輸出:myfunc
}
void foo()
{
show_name(__FUNCTION__); //輸出:foo
}
因為 __FUNCTION__ 會在函數大括弧開始之後就立即初始化,所以,foo()及myfunc()函數可在參數列表中安全地使用它,而不用擔心重載。
簽名與修飾名
__FUNCTION__ 特性最初是為C語言設計的,然而,C++程式員也會經常需要有關他們函數的額外資訊,在Visual Studio 2005中,還支援另外兩種非標準的擴充特性:__FUNCDNAME__ 與 __FUNCSIG__ ,其分別轉譯為一個函數的修飾名與簽名。函數的修飾名非常有用,例如,在你想要檢查兩個編譯器是否共用同樣的ABI時,就可派得上用場,另外,它還能協助你破解那些含義模糊的連結錯誤,甚至還可用它從一個DLL中調用另一個用C++連結的函數。在下例中,show_name()報告了函數的修飾名:
void myfunc()
{
show_name(__FUNCDNAME__); //輸出:?myfunc@@YAXXZ
}
一個函數的簽名由函數名、參數列表、傳回型別、內含的命名空間組成。假如它是一個成員函數,它的類名和const/volatile限定符也將是簽名的一部分。以下的代碼示範了一個獨立的函數與一個const成員函數簽名間的不同之處,兩個函數的名稱、傳回型別、參數完全相同:
void myfunc()
{
show_name(__FUNCSIG__); // void __cdecl myfunc(void)
}
strUCt S
{
void myfunc() const
{
show_name(__FUNCSIG__); //void __thiscall S::myfunc(void) const
}
};
以上就是在C語言中以編程的方式擷取函數名的內容,更多相關文章請關注topic.alibabacloud.com(www.php.cn)!