阿里云可以做电影网站,网站微信认证,免费网站看完你会回来感谢我的,男性问题免费咨询HiLog
Overview
Description:
HiLog模块实现日志打印功能。
开发者可以通过使用这些接口实现日志相关功能#xff0c;输出日志时可以指定日志类型、所属业务领域、日志TAG标识、日志级别等。
syscap SystemCapability.HiviewDFX.HiLog
Since:
8
Summary
Files
File …HiLog
Overview
Description:
HiLog模块实现日志打印功能。
开发者可以通过使用这些接口实现日志相关功能输出日志时可以指定日志类型、所属业务领域、日志TAG标识、日志级别等。
syscap SystemCapability.HiviewDFX.HiLog
Since:
8
Summary
Files
File NameDescription[log.h]HiLog模块日志接口定义通过这些接口实现日志打印相关功能。
Macros
Macro Name and ValueDescriptionLOG_DOMAIN 0日志所对应的业务领域用于标识业务的子系统、模块。LOG_TAG NULL字符串常量标识调用所在的类或者业务。OH_LOG_DEBUG(type, …) ((void)OH_LOG_Print((type), LOG_DEBUG, LOG_DOMAIN, LOG_TAG, VA_ARGS))DEBUG级别写日志宏封装接口。OH_LOG_INFO(type, …) ((void)OH_LOG_Print((type), LOG_INFO, LOG_DOMAIN, LOG_TAG, VA_ARGS))INFO级别写日志宏封装接口。OH_LOG_WARN(type, …) ((void)OH_LOG_Print((type), LOG_WARN, LOG_DOMAIN, LOG_TAG, VA_ARGS))WARN级别写日志宏封装接口。OH_LOG_ERROR(type, …) ((void)OH_LOG_Print((type), LOG_ERROR, LOG_DOMAIN, LOG_TAG, VA_ARGS))ERROR级别写日志宏封装接口。OH_LOG_FATAL(type, …) ((void)HiLogPrint((type), LOG_FATAL, LOG_DOMAIN, LOG_TAG, VA_ARGS))FATAL级别写日志宏封装接口。
Enumerations
Enumeration NameDescriptionLogType { LOG_APP 0 }日志类型。LogLevel { LOG_DEBUG 3, LOG_INFO 4, LOG_WARN 5, LOG_ERROR 6, LOG_FATAL 7 }日志级别。
Functions
FunctionDescriptionOH_LOG_Print (LogType type, LogLevel level, unsigned int domain, const char *tag, const char *fmt,…) attribute((format(os_logint 写日志接口。OH_LOG_IsLoggable (unsigned int domain, const char *tag, LogLevel level)int bool 检查指定业务领域、TAG、级别的日志是否可以打印。
Details
Macro Definition
LOG_DOMAIN
#define LOG_DOMAIN 0Description:
日志所对应的业务领域用于标识业务的子系统、模块。
16进制整数有效范围0x0~0xFFFF超过自动截掉高位。
LOG_TAG
#define LOG_TAG NULLDescription:
字符串常量标识调用所在的类或者业务。
OH_LOG_DEBUG
#define OH_LOG_DEBUG( type, ... ) ((void)OH_LOG_Print((type), LOG_DEBUG, LOG_DOMAIN, LOG_TAG, __VA_ARGS__))Description:
DEBUG级别写日志宏封装接口。
使用时需要先定义日志业务领域、日志TAG一般在源文件起始处统一定义一次。
Parameters:
NameDescriptiontype日志类型三方应用日志类型为LOG_APP。fmt格式化字符串基于类printf格式的增强支持隐私参数标识即在格式字符串每个参数中符号后类型前增加{public}、{private}标识。…与格式字符串里参数类型对应的参数列表参数数目、参数类型必须与格式字符串中的标识一一对应。
See also:
[OH_LOG_Print]
OH_LOG_ERROR
#define OH_LOG_ERROR( type, ... ) ((void)OH_LOG_Print((type), LOG_ERROR, LOG_DOMAIN, LOG_TAG, __VA_ARGS__))Description:
ERROR级别写日志宏封装接口。
使用时需要先定义日志业务领域、日志TAG一般在源文件起始处统一定义一次。
Parameters:
NameDescriptiontype日志类型三方应用日志类型为LOG_APP。fmt格式化字符串基于类printf格式的增强支持隐私参数标识即在格式字符串每个参数中符号后类型前增加{public}、{private}标识。…与格式字符串里参数类型对应的参数列表参数数目、参数类型必须与格式字符串中的标识一一对应。
See also:
OH_LOG_Print
OH_LOG_FATAL
#define OH_LOG_FATAL( type, ... ) ((void)HiLogPrint((type), LOG_FATAL, LOG_DOMAIN, LOG_TAG, __VA_ARGS__))Description:
FATAL级别写日志宏封装接口。
使用时需要先定义日志业务领域、日志TAG一般在源文件起始处统一定义一次。
Parameters:
NameDescriptiontype日志类型三方应用日志类型为LOG_APP。fmt格式化字符串基于类printf格式的增强支持隐私参数标识即在格式字符串每个参数中符号后类型前增加{public}、{private}标识。…与格式字符串里参数类型对应的参数列表参数数目、参数类型必须与格式字符串中的标识一一对应。
See also:
[OH_LOG_Print]
OH_LOG_INFO
#define OH_LOG_INFO( type, ... ) ((void)OH_LOG_Print((type), LOG_INFO, LOG_DOMAIN, LOG_TAG, __VA_ARGS__))Description:
INFO级别写日志宏封装接口。
使用时需要先定义日志业务领域、日志TAG一般在源文件起始处统一定义一次。
Parameters:
NameDescriptiontype日志类型三方应用日志类型为LOG_APP。fmt格式化字符串基于类printf格式的增强支持隐私参数标识即在格式字符串每个参数中符号后类型前增加{public}、{private}标识。…与格式字符串里参数类型对应的参数列表参数数目、参数类型必须与格式字符串中的标识一一对应。
See also:
[OH_LOG_Print]
OH_LOG_WARN
#define OH_LOG_WARN( type, ... ) ((void)OH_LOG_Print((type), LOG_WARN, LOG_DOMAIN, LOG_TAG, __VA_ARGS__))Description:
WARN级别写日志宏封装接口。
使用时需要先定义日志业务领域、日志TAG一般在源文件起始处统一定义一次。
Parameters:
NameDescriptiontype日志类型三方应用日志类型为LOG_APP。fmt格式化字符串基于类printf格式的增强支持隐私参数标识即在格式字符串每个参数中符号后类型前增加{public}、{private}标识。…与格式字符串里参数类型对应的参数列表参数数目、参数类型必须与格式字符串中的标识一一对应。
See also:
[OH_LOG_Print]
Enumeration Type
LogLevel
enum LogLevelDescription:
日志级别。
该枚举类型用于定义日志级别。
各级别建议使用方式
DEBUG比INFO级别更详细的流程记录通过该级别的日志可以更详细地分析业务流程和定位分析问题。DEBUG级别的日志在正式发布版本中默认不会被打印只有在调试版本或打开调试开关的情况下才会打印。
INFO用来记录业务关键流程节点可以还原业务的主要运行过程用来记录非正常情况信息但这些情况都是可以预期的(如无网络信号、登录失败等)。这些日志都应该由该业务内处于支配地位的模块来记录避免在多个被调用的模块或低级函数中重复记录。
WARN发生了较为严重的非预期情况但是对用户影响不大程序可以自动恢复或通过简单的操作就可以恢复的问题。
ERROR程序或功能发生了错误该错误会影响功能的正常运行或用户的正常使用可以恢复但恢复代价较高如重置数据等。
FATAL重大致命异常表明程序或功能即将崩溃故障无法恢复。
EnumeratorDescriptionLOG_DEBUGDEBUG日志级别使用OH_LOG_DEBUG接口打印LOG_INFOINFO日志级别使用OH_LOG_INFO接口打印LOG_WARNWARN日志级别使用OH_LOG_WARN接口打印LOG_ERRORERROR日志级别使用OH_LOG_ERROR接口打印LOG_FATALFATAL日志级别使用OH_LOG_FATAL接口打印
LogType
enum LogTypeDescription:
日志类型。
该枚举类型用于定义应用开发者可以使用的日志类型。当前有应用日志LOG_APP。
EnumeratorDescriptionLOG_APP应用日志
Function
OH_LOG_IsLoggable()
int bool OH_LOG_IsLoggable (unsigned int domain, const char * tag, LogLevel level )Description:
检查指定业务领域、TAG、级别的日志是否可以打印。
Parameters:
NameDescriptiondomain指定日志业务领域。tag指定日志TAG。level指定日志level。
Returns:
如果指定domain、tag、level日志可以打印则返回true否则返回false。
OH_LOG_Print()
int OH_LOG_Print (LogType type, LogLevel level, unsigned int domain, const char * tag, const char * fmt, ... )Description:
写日志接口。
指定日志类型、日志级别、业务领域、TAG按照类printf格式类型和隐私指示确定需要输出的变参。
Parameters:
NameDescriptiontype日志类型三方应用日志类型为LOG_APP。level日志级别日志级别包括LOG_DEBUG、LOG_INFO、LOG_WARN、LOG_ERROR、LOG_FATAL。domain日志业务领域16进制整数范围0x0~0xFFFF。tag日志TAG字符串标识调用所在的类或者业务。fmt格式化字符串基于类printf格式的增强支持隐私参数标识即在格式字符串每个参数中符号后类型前增加{public}、{private}标识。…与格式字符串里参数类型对应的参数列表参数数目、参数类型必须与格式字符串中的标识一一对应。 Returns:
大于等于0表示成功小于0表示失败。