addseverity

頭檔案

#include <fmtmsg.h>

函式原型

int addseverity(int severity, const char *s);

說明

本函式允許為一個新的嚴重性類型添加描述信息，然後我們可以通過以 severity 作為 fmtmsg(3) 的參數來訪問。默認情況下後者只知道如何列印嚴重性等級為 0-4 (分別加前綴：(空)、HALT、ERROR、WARNING、INFO)。本函式為給定的值 severity 追加一個前綴 s。如果 s 是 NULL，以 severity 為編號嚴重性類型訊息將被刪除。不可能覆寫或刪除一個默認的嚴重性類型。嚴重性編號必須是一個非負值。

注意：新的嚴重性類型還可以通過環境變數 SEV_LEVEL 來設定。儘管 fmtmsg(3) 是一個 X/Open Protability Guide 指定的函式，但本函式不是。它在存在於 System V 里。

成功時，值 MM_OK 被返回。錯誤時，返回的值是 MM_NOTOK。可能的錯誤包括：記憶體不足，試圖去刪除一個不存在的或默認的嚴重性類型。