當(dāng)前位置:首頁 > 公眾號精選 > 嵌入式大雜燴
[導(dǎo)讀]點(diǎn)擊上方「嵌入式大雜燴」,選擇「置頂公眾號」第一時間查看編程筆記! 宏打印函數(shù) 在我們的嵌入式開發(fā)中,使用printf打印一些信息是一種常用的調(diào)試手段。但是,在打印的信息量比較多的時候,就比較難知道哪些信息在哪個函數(shù)里進(jìn)行打印。 特別是對于異常情況

點(diǎn)擊上方「嵌入式大雜燴」,選擇「置頂公眾號」第一時間查看編程筆記!

宏打印函數(shù)

在我們的嵌入式開發(fā)中,使用printf打印一些信息是一種常用的調(diào)試手段。但是,在打印的信息量比較多的時候,就比較難知道哪些信息在哪個函數(shù)里進(jìn)行打印。

特別是對于異常情況的打印,我們需要快速定位到異常情況的位置。

這時候我們可以使用宏定義來封裝一個宏打印函數(shù),這個宏打印函數(shù)可以顯示打印信息所在的文件、行數(shù)、函數(shù)名等信息。如:

左右滑動查看全部代碼>>>

#define DBG_PRINTF(fmt, args...)  \
{\
 printf("<<File:%s  Line:%d  Function:%s>> ", __FILE__, __LINE__, __FUNCTION__);\
 printf(fmt, ##args);\
}


使用范例:


可見,使用方法與printf的使用方法一樣,而且每條打印語句開頭都會打印調(diào)試信息所在的文件名、行號、函數(shù)名信息,方便我們查找一些調(diào)試信息。

其中,__FILE__、__LINE__、__FUNCTION__這三個宏是編譯器內(nèi)置宏定義,分別代表調(diào)試信息所在文件、行號、函數(shù)。

除此之外,常用的宏還有:__DATE__、__TIME__,分別代表當(dāng)前的編譯日期與時間。如:

DBG_PRINTF("Compile Time: %s  %s\n", __DATE__, __TIME__);


第二條printf中的##符號是為了處理args不代表任何參數(shù)的情況。如:

DBG_PRINTF("Hello world");

當(dāng)不加##符號是,以上宏的第二條語句被拓展為:

printf("Hello world\n", );

可見,多出了一個逗號,這個逗號是多余的。

加上##符號后,以上宏的第二條語句被拓展為:

printf("Hello world\n");

這才是我們想要的結(jié)果。其實這些結(jié)果我們通過查看預(yù)處理文件可以清晰的知道:


最后需要注意的是,這個DBG_PRINTF還是與printf不一樣的。DBG_PRINTF宏是兩條語句的組合,無返回值;而printf的原型是:

int printf (const char *__format, ...)

但是我們一般都很少使用printf的返回值,所以DBG_PRINTF的用法與printf函數(shù)基本一致。

打印調(diào)試宏開關(guān)

通常情況下,一些打印調(diào)試信息只是在我們調(diào)試階段需要的,在程序發(fā)布階段是不需要的。

所以,為了避免打印調(diào)試信息帶來的資源開銷,我們可以把這些打印調(diào)試語句給注釋掉。

一種方法是逐句進(jìn)行注釋,這是一種比較低效的方法。比較高效的方法就是添加調(diào)試宏開關(guān),利用條件編譯來選擇打印/不打印調(diào)試信息。

比如我們可以把上面的代碼改造為:

#define  DEBUG   1  

#if DEBUG
  #define DBG_PRINTF(fmt, args...)  \
  {\
    printf("<<File:%s  Line:%d  Function:%s>> ", __FILE__, __LINE__, __FUNCTION__);\
    printf(fmt, ##args);\
  }

#else
  #define DBG_PRINTF(fmt, args...)   
#endif

根據(jù)DEBUG宏的值來選擇對應(yīng)的打印宏函數(shù)。當(dāng)DEBUG的值為1時啟動相關(guān)的打印調(diào)試語句,DEBUG的值為0時則關(guān)閉打印調(diào)試語句。

這樣我們就可以很方便的通過設(shè)置DEBUG宏的值來啟動與關(guān)閉我們整個工程的DBG_PRINTF打印調(diào)試信息。

do{}while(0)

其實,上面我們封裝的打印宏DBG_PRINTF還有一點(diǎn)缺陷,比如我們與if、else使用的時候,會有這樣的一種使用情況:


此時會報語法錯誤。為什么呢?

同樣的,我們可以先來看一下我們的demo代碼預(yù)處理過后,相應(yīng)的宏代碼會被轉(zhuǎn)換為什么。如:


這里我們可以看到,我們的if、else結(jié)構(gòu)代碼被替換為如下形式:

if(c)
/* ....... */ };
else
/* ....... */ };

顯然,出現(xiàn)了語法錯誤。if之后的大括號之后不能加分號,這里的分號其實可以看做一條空語句,這個空語句會把if與else給分隔開來,導(dǎo)致else不能正確匹配到if,導(dǎo)致語法錯誤。

為了解決這個問題,有幾種方法。第一種方法是:把分號去掉。代碼變成:


第二種方法是:在if之后使用DBG_PRINTF打印調(diào)試時總是加{}。代碼變成:


以上兩種方法都可以正常編譯、運(yùn)行了。

但是,我們C語言中,每條語句往往以分號結(jié)尾;并且,總有些人習(xí)慣在if判斷之后只有一條語句的情況下不加大括號;而且我們創(chuàng)建的DBG_PRINTF宏函數(shù)的目的就是為了對標(biāo)printf函數(shù),printf函數(shù)的使用加分號在任何地方的使用都是沒有問題的。

基于這幾個原因,我們有必要再對我們的DBG_PRINTF宏函數(shù)進(jìn)行一個改造。

下面引入do{}while(0)來對我們的DBG_PRINTF進(jìn)行一個簡單的改造。改造后的DBG_PRINTF宏函數(shù)如下:

#define DBG_PRINTF(fmt, args...)  \
do\
{\
printf("<<File:%s Line:%d Function:%s>> ", __FILE__, __LINE__, __FUNCTION__);\
printf(fmt, ##args);\
}while(0)

這里的do...while循環(huán)的循環(huán)體只執(zhí)行一次,與不加循環(huán)是效果一樣。并且,可以避免了上面的問題。預(yù)處理文件:


我們的宏函數(shù)實體中,while(0)后面不加分號,在實際調(diào)用時補(bǔ)上分號,既符合了C語言語句分號結(jié)尾的習(xí)慣,也符合了do...while的語法規(guī)則。

使用do{}while(0)來封裝宏函數(shù)可能會讓很多初學(xué)者看著不習(xí)慣,但必須承認(rèn)的是,這確確實實是一種很常用的方法。

在STM32的HAL庫中搜索while(0):


在Linux源碼中搜索while(0):


可見,在實際應(yīng)用中,do{}while(0)用的很多。

#運(yùn)算符與##運(yùn)算符

這兩個運(yùn)算符之前也有分享過,這里順便也提一下。

#號作為一個預(yù)處理運(yùn)算符,可以把記號轉(zhuǎn)換成字符串。

例如,如果A是一個宏形參,那么#A就是轉(zhuǎn)換為字符串"A"的形參名。這個過程稱字符串化(stringizing)。以下程序演示這個過程:


##運(yùn)算符可以把兩個記號組合成一個記號。以下程序演示這個過程:


這個運(yùn)算符用得很多。如:

最后

以上就是本次的分享。如有錯誤,歡迎指出!謝謝

本篇筆記會同步至我的個人博客:https://www.lizhengnian.cn/中,歡迎來訪。

原創(chuàng)不易,期待您的在看、分享~


猜你喜歡:

C語言、嵌入式重點(diǎn)知識:回調(diào)函數(shù)

C語言、嵌入式位操作精華技巧大匯總

C語言編譯的幾個過程

【Linux筆記】設(shè)備樹實例分析

【Linux筆記】通俗易懂的Linux驅(qū)動基礎(chǔ)

【Linux筆記】pc機(jī)_開發(fā)板_ubuntu互ping實驗
【Linux筆記】掛載網(wǎng)絡(luò)文件系統(tǒng)

學(xué)習(xí)STM32的一些經(jīng)驗分享

基于LiteOS的智慧農(nóng)業(yè)案例實驗分享

從單片機(jī)工程師的角度看嵌入式Linux



后臺回復(fù):加群。添加ZhengN微信,加入交流群



點(diǎn)個贊,證明你還愛我

免責(zé)聲明:本文內(nèi)容由21ic獲得授權(quán)后發(fā)布,版權(quán)歸原作者所有,本平臺僅提供信息存儲服務(wù)。文章僅代表作者個人觀點(diǎn),不代表本平臺立場,如有問題,請聯(lián)系我們,謝謝!

本站聲明: 本文章由作者或相關(guān)機(jī)構(gòu)授權(quán)發(fā)布,目的在于傳遞更多信息,并不代表本站贊同其觀點(diǎn),本站亦不保證或承諾內(nèi)容真實性等。需要轉(zhuǎn)載請聯(lián)系該專欄作者,如若文章內(nèi)容侵犯您的權(quán)益,請及時聯(lián)系本站刪除。
換一批
延伸閱讀

9月2日消息,不造車的華為或?qū)⒋呱龈蟮莫?dú)角獸公司,隨著阿維塔和賽力斯的入局,華為引望愈發(fā)顯得引人矚目。

關(guān)鍵字: 阿維塔 塞力斯 華為

加利福尼亞州圣克拉拉縣2024年8月30日 /美通社/ -- 數(shù)字化轉(zhuǎn)型技術(shù)解決方案公司Trianz今天宣布,該公司與Amazon Web Services (AWS)簽訂了...

關(guān)鍵字: AWS AN BSP 數(shù)字化

倫敦2024年8月29日 /美通社/ -- 英國汽車技術(shù)公司SODA.Auto推出其旗艦產(chǎn)品SODA V,這是全球首款涵蓋汽車工程師從創(chuàng)意到認(rèn)證的所有需求的工具,可用于創(chuàng)建軟件定義汽車。 SODA V工具的開發(fā)耗時1.5...

關(guān)鍵字: 汽車 人工智能 智能驅(qū)動 BSP

北京2024年8月28日 /美通社/ -- 越來越多用戶希望企業(yè)業(yè)務(wù)能7×24不間斷運(yùn)行,同時企業(yè)卻面臨越來越多業(yè)務(wù)中斷的風(fēng)險,如企業(yè)系統(tǒng)復(fù)雜性的增加,頻繁的功能更新和發(fā)布等。如何確保業(yè)務(wù)連續(xù)性,提升韌性,成...

關(guān)鍵字: 亞馬遜 解密 控制平面 BSP

8月30日消息,據(jù)媒體報道,騰訊和網(wǎng)易近期正在縮減他們對日本游戲市場的投資。

關(guān)鍵字: 騰訊 編碼器 CPU

8月28日消息,今天上午,2024中國國際大數(shù)據(jù)產(chǎn)業(yè)博覽會開幕式在貴陽舉行,華為董事、質(zhì)量流程IT總裁陶景文發(fā)表了演講。

關(guān)鍵字: 華為 12nm EDA 半導(dǎo)體

8月28日消息,在2024中國國際大數(shù)據(jù)產(chǎn)業(yè)博覽會上,華為常務(wù)董事、華為云CEO張平安發(fā)表演講稱,數(shù)字世界的話語權(quán)最終是由生態(tài)的繁榮決定的。

關(guān)鍵字: 華為 12nm 手機(jī) 衛(wèi)星通信

要點(diǎn): 有效應(yīng)對環(huán)境變化,經(jīng)營業(yè)績穩(wěn)中有升 落實提質(zhì)增效舉措,毛利潤率延續(xù)升勢 戰(zhàn)略布局成效顯著,戰(zhàn)新業(yè)務(wù)引領(lǐng)增長 以科技創(chuàng)新為引領(lǐng),提升企業(yè)核心競爭力 堅持高質(zhì)量發(fā)展策略,塑強(qiáng)核心競爭優(yōu)勢...

關(guān)鍵字: 通信 BSP 電信運(yùn)營商 數(shù)字經(jīng)濟(jì)

北京2024年8月27日 /美通社/ -- 8月21日,由中央廣播電視總臺與中國電影電視技術(shù)學(xué)會聯(lián)合牽頭組建的NVI技術(shù)創(chuàng)新聯(lián)盟在BIRTV2024超高清全產(chǎn)業(yè)鏈發(fā)展研討會上宣布正式成立。 活動現(xiàn)場 NVI技術(shù)創(chuàng)新聯(lián)...

關(guān)鍵字: VI 傳輸協(xié)議 音頻 BSP

北京2024年8月27日 /美通社/ -- 在8月23日舉辦的2024年長三角生態(tài)綠色一體化發(fā)展示范區(qū)聯(lián)合招商會上,軟通動力信息技術(shù)(集團(tuán))股份有限公司(以下簡稱"軟通動力")與長三角投資(上海)有限...

關(guān)鍵字: BSP 信息技術(shù)
關(guān)閉
關(guān)閉