ACE日誌使用指南

2023-01-19 01:06:02 字數 2261 閱讀 5917

廣州從興電子開發****

文件修改歷史

目錄1 ace日誌概述 5

2 基本使用 5

2.1 日誌輸出巨集 5

2.2 日誌的等級 5

2.3 格式化指令 6

2.4 例1-日誌的簡單示例 8

3 日誌的輸出過濾 9

3.1 輸出過濾原理 9

3.2 編譯時刻設定 9

3.3 執行時刻設定 11

3.4 例2-執行時刻的日誌過濾示例 12

4 日誌的輸出重定向 13

4.1 重定向涉及函式 13

4.2 重定向到標準錯誤 14

4.3 重定向到輸出流 15

4.4 例3-輸出重定向綜合示例 15

5 **機制 16

5.1 使用步驟 16

5.2 例4-**機制示例 17

6 使用logging strategy進行執行時配置 18

6.1 ace_logging_strategy支援的引數 18

6.2 例5-執行配置示例 19

7 c/s方式的日誌 20

7.1 **方式 20

7.1.1 例6-**方式的c/s日誌示例 20

7.2 直連方式 22

7.2.1 例7-直連方式的c/s日誌示例 22

7 定製ace日誌 25

7.1 定製日誌輸出巨集 25

7.1.1 定製涉及函式 25

7.1.2 例8-日誌輸出巨集的定製示例 26

7.2 封裝ace日誌 30

7.2.1 例9-ace日誌封裝示例 30

ace日誌服務是ace庫的乙個功能模組,具有執行緒安全、靈活、分級顯示等特點,可以面向程式除錯、執行、測試、和維護等全生命週期,可以選擇將資訊輸出到螢幕、檔案、系統日誌(如windows下的event log)、甚至是遠端伺服器。除此之外,ace日誌系統支援**函式以及執行時刻動態配置(runtime configuration )。

ace日誌的使用主要通過巨集ace_***((severity, formatting-args))進行日誌輸出。其中severity為日誌等級(參見2.2小節),formatting-args是要輸出的內容,類似printf()函式的可變引數,其中也可以包含以』%』開頭的格式化指令(見2.

3小節)。

注意日誌輸出巨集包括兩層圓括號,外層括號是為了巨集展開時指定巨集的引數,內層的括號則為了巨集展開成函式後指定函式引數。日誌輸出巨集包括:

● ace_error((level, string, ...))

● ace_debug((level, string, ...))

● ace_trace(string)

● ace_assert(test)

● ace_hex_dump((level, buffer, size [,text]))

● ace_return(value)

● ace_error_return((level, string, ...), value)

● ace_error_init( value, flags )

● ace_error_break((level, string, ...))

ace日誌的的等級如表2-1所示。

表2-1 ace日誌的等級

ace日誌支援的格式化指令如表2-2所示。

表2-2 ace日誌支援的格式化指令

ace日誌簡單示例如以下**所示。

注意標頭檔案」ace/log_的包含,以及使用2.1小節介紹的日誌輸出巨集進行的日誌輸出。日誌輸出巨集內層括號包括日誌等級和日誌內容兩個引數。

由於等級為lm_trace的日誌訊息預設是被過濾的,因此本例中定義了巨集」#define ace_ntrace 0」利用條件編譯使其能夠輸出。具體參見3.2.2小節。

輸出結果:

(5396) calling main in file `d:\workspace\c++\ace\日誌服務\******example\' on line 8

hi mom

(5396) calling foo in file `d:\workspace\c++\ace\日誌服務\ ******example\' on line 18

howdy pardner

(5396) le**ing foo

goodnight

(5396) le**ing main

Oracle系統使用指南

2011 2012學年度申報 審批 要求指南 一 活動申報指南 二 活動審批指南 三 活動要求指南 1 每月20 28日開放系統,用以申報下月活動並上傳相關活動資料。並且在同一時間段,上傳已完成的活動的活動人員加分名單 活動總結 以及新增附件所需要的內容。2 下月5 7日,補報當月未開展的活動,補傳...

DE 磁性材料使用指南

一 磁性材料基本知識 1,磁性材料分 鐵氧體磁體,金屬磁體,稀土磁體。由於工藝不同,各種材料的磁體又分為 燒結磁,粘結磁,塑磁。如粘接釹鐵硼,燒結釹鐵硼 1 鐵氧體磁體 srco3 6fe2o3 srfe12o19 鐵磁體 2 鐵氧體磁體由六角晶體的單晶組成,每個單晶相當於乙個磁針,一頭n極,一頭s...

知雲文獻翻譯使用指南

不配一款神器,科研哪來效率!有了這款神器,科研都變得更簡單!用它直接開啟英文pdf文獻,隨便選中一段話,右側立即給出翻譯,不再需要拷貝到網頁上翻譯,不彈出討厭的懸浮框,這種使用邏輯用起來舒心,兼顧理解與英文學習。軟體有多個翻譯引擎供選擇。其中引擎3專門優化專業詞彙,接近真人翻譯,非常適合用來閱讀科研...