Skip to content

Commit

Permalink
updated docs.
Browse files Browse the repository at this point in the history
  • Loading branch information
treefrogframework committed Nov 29, 2024
1 parent 44a4796 commit 14f06fe
Show file tree
Hide file tree
Showing 3 changed files with 48 additions and 6 deletions.
18 changes: 16 additions & 2 deletions docs/ch/user-guide/helper-reference/logging.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,17 +32,31 @@ page_id: "080.050"
参数可以像格式化字符串和变量的printf格式一样传递. 举例, 像这样:

```c++
tError("Invalid Parameter : value : %d", value);
tError("Invalid Parameter, value : %d", value);
```
然后, 下面的记录将会输出到*log/app.log*文件:
```
2011-04-01 21:06:04 ERROR [12345678] Invalid Parameter : value : -1
2011-04-01 21:06:04 ERROR [12345678] Invalid Parameter, value : -1
```
在格式化字符串的尾部不需要换行符.
在 TreeFrog 2.10 及更高版本中,如果编译器支持 stdc++20,则可以使用以下方法来描述 std::format 样式格式化.
* Tf::fatal()
* Tf::error()
* Tf::warn()
* Tf::info()
* Tf::debug()
* Tf::trace()
其写法如下:
```c++
Tf::error("Invalid Parameter, value : {}", value);
```

## 更改记录的布局

通过设置FileLogger能够改变记录输出的布局. 布局参数在配置文件*logger.ini*中.
Expand Down
18 changes: 16 additions & 2 deletions docs/en/user-guide/helper-reference/logging.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,17 +32,31 @@ The application log is used for logging your Web application. There are several
Arguments that can be passed here are the same as the printf-format of format string and a variable number. For example, like this:

```c++
tError("Invalid Parameter : value : %d", value);
tError("Invalid Parameter, value : %d", value);
```
Then, the following log will be output to the *log/app.log* file:
```
2011-04-01 21:06:04 ERROR [12345678] Invalid Parameter : value : -1
2011-04-01 21:06:04 ERROR [12345678] Invalid Parameter, value : -1
```
Line feed code is not required at the end of the format string.
In TreeFrog version 2.10 and later, if the compiler supports stdc++20, you can use the following methods to describe std::format style formatting.
* Tf::fatal()
* Tf::error()
* Tf::warn()
* Tf::info()
* Tf::debug()
* Tf::trace()
It can be written as follows:
```c++
Tf::error("Invalid Parameter, value : {}", value);
```

## Changing Log Layout

It is possible to change the layout of the log output, by setting FileLogger.Layout parameters in the configuration file *logger.ini*.
Expand Down
18 changes: 16 additions & 2 deletions docs/ja/user-guide/helper-reference/logging.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,17 +32,31 @@ Webアプリは、以下の4つのログを出力します。
渡せる引数は printf 形式と同じで、フォーマット文字列と可変個の変数です。例えば、こんな感じに使います。

```c++
tError("Invalid Parameter : value : %d", value);
tError("Invalid Parameter, value : %d", value);
```
すると、次のようなログが log/app.log ファイルに出力されるでしょう。
```
2011-04-01 21:06:04 ERROR [12345678] Invalid Parameter : value : -1
2011-04-01 21:06:04 ERROR [12345678] Invalid Parameter, value : -1
```
フォーマット文字列の末尾には改行コードは不要です。
TreeFrog バージョン2.10以降では、stdc++20をサポートしたコンパイラであれば、次のメソッドで std::format スタイルの書式を記述できます。
* Tf::fatal()
* Tf::error()
* Tf::warn()
* Tf::info()
* Tf::debug()
* Tf::trace()
次のように記述できます。
```c++
Tf::error("Invalid Parameter, value : {}", value);
```

## ログのレイアウト変更

出力されるログのレイアウトを変更することが可能です。logger.ini 設定ファイルにある FileLogger.Layout パラメータに設定します。
Expand Down

0 comments on commit 14f06fe

Please sign in to comment.