1# 使用HiLog打印日志（C/C++）
2
3在应用开发过程中，可在关键代码处输出日志信息。在运行应用后，通过查看日志信息来分析应用执行情况（如应用是否正常运行、代码运行时序、运行逻辑分支是否正常等）。
4
5HiLog日志系统，提供给系统框架、服务、以及应用，用于打印日志，记录用户操作、系统运行状态等。
6
7## 接口说明
8
9HiLog中定义了DEBUG、INFO、WARN、ERROR、FATAL五种日志级别，并提供了对应的方法输出不同级别的日志，接口如下表所示，具体说明可查阅[API参考文档](../reference/apis-performance-analysis-kit/_hi_log.md)。
10
11| 方法/宏 | 接口描述 |
12| -------- | -------- |
13| bool OH_LOG_IsLoggable(unsigned int domain, const char \*tag, LogLevel level) | 检查指定domain、tag和日志级别的日志是否可以打印。<br/>如果指定日志可以打印则返回true；否则返回false。 |
14| int OH_LOG_Print(LogType type, LogLevel level, unsigned int domain, const char \*tag, const char \*fmt, ...) | 输出指定domain、tag和日志级别的日志，并按照printf格式类型和隐私指示确定需要输出的变参。<br/>打印成功则返回日志总字节数；失败则返回-1。 |
15| \#define OH_LOG_DEBUG(type, ...) ((void)OH_LOG_Print((type), LOG_DEBUG, LOG_DOMAIN, LOG_TAG, \_\_VA_ARGS__)) | DEBUG级别写日志，宏封装接口。 |
16| \#define OH_LOG_INFO(type, ...) ((void)OH_LOG_Print((type), LOG_INFO, LOG_DOMAIN, LOG_TAG, \_\_VA_ARGS__)) | INFO级别写日志，宏封装接口。 |
17| \#define OH_LOG_WARN(type, ...) ((void)OH_LOG_Print((type), LOG_WARN, LOG_DOMAIN, LOG_TAG, \_\_VA_ARGS__)) | WARN级别写日志，宏封装接口。 |
18| \#define OH_LOG_ERROR(type, ...) ((void)OH_LOG_Print((type), LOG_ERROR, LOG_DOMAIN, LOG_TAG, \_\_VA_ARGS__)) | ERROR级别写日志，宏封装接口。 |
19| \#define OH_LOG_FATAL(type, ...) ((void)OH_LOG_Print((type), LOG_FATAL, LOG_DOMAIN, LOG_TAG, \_\_VA_ARGS__)) | FATAL级别写日志，宏封装接口。 |
20| void OH_LOG_SetCallback(LogCallback callback) | 注册函数，注册后可通过LogCallback回调获取本进程所有的hilog日志。|
21
22### 参数解析
23
24> **说明：**
25>
26> OH_LOG_IsLoggable()和OH_LOG_Print()使用的domain、tag和level应保持一致。
27
28- domain：用于指定输出日志所对应的业务领域，取值范围为0x0000~0xFFFF，开发者可以根据需要进行自定义。
29
30- tag：用于指定日志标识，可以为任意字符串，建议标识调用所在的类或者业务行为。tag最多为31字节，超出后会截断，不建议使用中文字符，可能出现乱码或者对齐问题。
31
32- level：用于指定日志级别。取值见[LogLevel](../reference/apis-performance-analysis-kit/_hi_log.md#loglevel)。
33
34- fmt：格式字符串，用于日志的格式化输出。日志打印的格式化参数需按照“%{private flag}specifier”的格式打印。
35  | 隐私标识符（private flag） | 说明 |
36  | -------- | -------- |
37  | private | 表示日志打印结果不可见，输出结果为&lt;private&gt;。 |
38  | public | 表示日志打印结果可见，明文显示参数。 |
39  | 无 | 缺省值默认为private，日志打印结果不可见。 |
40
41  | 格式说明符（specifier） | 说明 | 示例 |
42  | -------- | -------- | -------- |
43  | d/i | 支持打印number、bool和bigint类型。 | 123 |
44  | s | 支持打印string、undefined和null类型。 | "123" |
45
46  格式字符串中可以设置多个参数，例如格式字符串为“%s World”，“%s”为参数类型为string的变参标识，具体取值在args中定义。<!--Del-->
47
48  调试时可通过命令“hilog -p off”指令，关闭隐私开关，明文显示private日志内容。
49<!--DelEnd-->
50
51- args：可以为0个或多个参数，是格式字符串中参数类型对应的参数列表。参数的数量、类型必须与格式字符串中的标识一一对应。
52
53## 约束与限制
54
55日志打印最多打印4096字节，超出限制文本将被截断。
56
57## 开发步骤
58
591. 在CMakeLists.txt中新增libhilog_ndk.z.so链接：
60
61   ```
62   target_link_libraries(entry PUBLIC libhilog_ndk.z.so)
63   ```
64
652. 在源文件中包含hilog头文件, 并定义domain、tag宏：
66
67   ```c++
68   #include "hilog/log.h"
69   ```
70
71   ```c++
72   #undef LOG_DOMAIN
73   #undef LOG_TAG
74   #define LOG_DOMAIN 0x3200  // 全局domain宏，标识业务领域
75   #define LOG_TAG "MY_TAG"   // 全局tag宏，标识模块日志tag
76   ```
77
783. 打印日志，以打印ERROR级别的日志为例：
79
80   ```c++
81   OH_LOG_ERROR(LOG_APP, "Failed to visit %{private}s, reason:%{public}d.", url, errno);
82   ```
83
844. 输出结果：
85
86   ```
87   12-11 12:21:47.579  2695 2695 E A03200/MY_TAG: Failed to visit <private>, reason:11.
88   ```
89
90### 日志回调接口使用示例
91
92> **注意**
93>
94> 回调函数里面不允许再调用hilog接口打印日志，不然会死循环
95
96```c++
97#include "hilog/log.h"
98static constexpr OHOS::HiviewDFX::HiLogLabel LABEL = {LOG_CORE, 0xD003200, "MY_TAG"};
99
100// 回调函数，开发者自定义的日志处理函数
101void MyHiLog(const LogType type, const LogLevel level, const unsigned int domain, const char *tag, const char *msg)
102{
103    // user-defined to handle your log, such as redirect/filter
104    // 注意: 回调函数里面不允许再调用hilog接口打印日志，不然会死循环
105}
106
107static void Test(void)
108{
109   // 1.注册回调接口
110    OH_LOG_SetCallback(MyHiLog);
111
112   // 2.调用hilog接口打印日志，日志内容会输出到hilog，同时通过回调返回给MyHiLog，开发者可以在MyHiLog中自行处理日志
113   HiLog::Info(LABEL, "hello world");
114}
115```
116