1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
|
/*!
@~chinese
@ingroup dlog
@file include/log/AbstractStringAppender.h
@class Dtk::Core::AbstractStringAppender
@brief AbstractStringAppender类为处理纯文本格式的Appender提供了一个方便的基础日志
@details AbstractStringAppender是AbstractAppender类的简单扩展,
它提供了一种方便的方式来创建自定义日志应用程序, 该程序使用纯文本格式的日志.
它有`formattedString()`保护类型(不可直接被调用)函数, 可以根据`setFormat()`设置的格式来格式化日志参数。
@note 这个类不能直接实例化, 因为它包含从AbstractAppender类继承的纯虚函数。
@brief 关于自定义日志输出格式的更详细描述, 请参见setFormat()函数的文档
@sa AbstractStringAppender::setFormat()
@fn AbstractStringAppender Dtk::Core::AbstractStringAppender::AbstractStringAppender()
@brief 构建一个新的字符串appender对象
@fn QString Dtk::Core::AbstractStringAppender::format()
@brief 返回当前使用的format字符串
@details 默认记录格式为:`"%{time}{yyyy-MM-ddTHH:mm:ss.zzz} [%{type:-7}] <%{function}> %{message}\n"`
你可以使用setFormat()函数来设置不同的日志记录格式。
@sa AbstractStringAppender::setFormat()
@return 返回当前使用的format字符串
@fn void Dtk::Core::AbstractStringAppender::setFormat(const QString &format)
@brief 设置日志格式, 以便用这个appender向日志目标写入字符串。
@details
对于那些使用过标准sprintf函数的开发者来说, 字符串格式非常常见。
日志输出格式是一个简单的QString, 带有特殊的标记(以%符号开始), 在写日志记录时将被替换成它的内部含义。
控制标记以百分号(%)开始, 后面是{}括号内的命令(该命令描述了将被放入日志记录而不是标记的内容)。
可选的字段宽度参数可以在命令后直接指定（通过括号内的冒号）, 有些命令需要一个额外的格式化参数(在第二个{}括号内)
字段宽度参数的工作原理与`QString::arg()`fieldWidth参数几乎相同(并在内部使用它),
例如, "%{type:-7}"将被替换为消息的左边填充的调试级别("Debug")或其他东西。更详细的描述请参考Qt文档。
@details 支持的标记：
| **标记** | **含义** | **备注** |
|:-----------:|:-----------------------------------------------------:|:-------------------------------------------------------------------:|
| %{time} | 时间戳。你可以使用标记后的第二个{}括号来指定你的自定义时间戳格式。默认格式:"HH:mm:ss.zzz" | "%{time}{dd-MM-yyyy, HH:mm}"可能被替换为 "20-9-2022, 21:24", 这取决于当前的日期和时间。 |
| %{type} | 日志级别。可能的日志级别在Logger::LogLevel枚举中显示。 | |
| %{Type} | 大写的日志级别 | |
| %{typeOne} | 一个字母的日志级别 | |
| %{TypeOne} | 一个大写字母的日志级别 | |
| %{File} | 记录日志的文件的完整源文件名(含路径), 使用 `__FILE__`预处理程序宏 | |
| %{file} | 简短的文件名(去除路径后的文件名) | |
| %{line} | 源文件中的行数。使用`__LINE__`预处理程序宏。 | |
| %{Function} | 调用`LOG_*`宏的函数的名称。使用Qt提供的`Q_FUNC_INFO`宏。 | |
| %{function} | 类似于%{Function}, 但使用 stripFunctionName 剥离了函数名。 | |
| %{message} | 日志内容 | |
| %{category} | 日志类别 | |
| %{appname} | 应用程序名称(由`QCoreApplication::applicationName()`函数返回） | |
| %{pid} | 应用程序的pid(由`QCoreApplication::applicationPid()`函数返回) | |
| %{threadid} | 线程ID | |
| %% | 转译为单`%`标记 | |
@fn static QString Dtk::Core::AbstractStringAppender::stripFunctionName(const char *name)
@brief 剥离长函数签名(由Q_FUNC_INFO宏添加)
@details 字符串处理掉了函数的返回类型、参数和模板参数, 这对于提高日志输出的可读性是非常有用的
@param[in] name 函数名称
@return 剥离的函数名称
*/
|
