YSTest: Debug.h 文件参考

YSTest PreAlpha_b800_20170810 The YSLib Test Project

- 首页
- 相关页面
- 模块
- 命名空间
- 类
- 文件

- 文件列表
- 文件成员

类 | 命名空间 | 宏定义 | 函数
Debug.h 文件参考
YFramework Library » YCommonLib

YCLib 调试设施。 更多...

`#include "YModules.h"`
`#include <YCLib/YCommon.h>`
`#include <YCLib/Container.h>`
`#include <YCLib/Mutex.h>`
Debug.h 的引用(Include)关系图:
此图展示该文件直接或间接的被哪些文件引用了:

浏览源代码.

## 类

class | platform::Logger
| 日志记录器。 更多...

## 命名空间

| platform
| 默认平台命名空间。
| platform_ex
| 平台扩展命名空间。

## 宏定义

#define | YF_Use_TraceSrc 1
| 在跟踪日志中使用跟踪源码位置。 更多...
#define | YCL_Log(_lv, ...)
| 使用公共日志记录器记录日志格式字符串。 更多...
#define | YF_TraceRaw(_lv, ...)
| YFramework 跟踪。 更多...
#define | YF_Trace(_lv, ...)
| YCLib 默认调试跟踪。 更多...
#define | YTraceDe(...)
| YCLib 默认调试跟踪。 更多...

## 函数

YF_API bool | platform::Echo (string_view) ynoexcept(YF_Platform
| 使用标准输出流打印字符串并刷新。 更多...
YF_API Logger & | platform::FetchCommonLogger ()
| 取公共日志记录器。 更多...
YF_API | platform::YB_ATTR_gnu_printf (3, 4) YB_NONNULL(1
| 格式输出日志字符串前追加记录源文件名和行号。 更多...
YF_API string | platform::LogWithSource (const char *, int, const char *,...) ynothrow
template<typename _type >
_type && | platform::Nonnull (_type &&p) ynothrowv
| 断言并返回非空参数。 更多...
template<typename _type >
_type && | platform::FwdIter (_type &&i) ynothrowv
| 断言并返回可解引用的迭代器。 更多...
template<typename _type >
yconstfn auto | platform::Deref (_type &&p) -> decltype(*p)
| 断言并解引用非空指针。 更多...
| platform::ComposeMessageWithSignature
const string & | platform::msg
const string const char *sig const char * | platform::sig
| platform::YB_NONNULL (2) PDefH(string
| 组合消息和函数签名字符串。 更多...
const string const char *sig | platform::ImplRet (msg+" @ "+Nonnull(sig)) inline YB_NONNULL(1
const string const char *sig | platform::PDefH (string, ComposeMessageWithSignature, const char *msg, const char *sig) ImplRet(string(Nonnull(msg))+" @ "+Nonnull(sig)) template< class _type > inline YB_NONNULL(2) string ComposeMessageWithSignature(const _type &msg
return | platform::to_string (msg)+" @ "+Nonnull(sig)

## 详细描述

YCLib 调试设施。

版本
  r736

作者
  FrankHB frank.nosp@m.hb19.nosp@m.89@gm.nosp@m.ail..nosp@m.com

自从
  build 299

创建时间:
  2012-04-07 14:20:49 +0800

修改时间:
  2016-11-19 14:12 +0800

文本编码:
  UTF-8

模块名称:
  YCLib::Debug

在文件 Debug.h 中定义.

## 宏定义说明

#define YCL_Log | ( |  | _lv,
|  |  | ...
| ) |  |

值:
platform::FetchCommonLogger().Log( \
platform::Descriptions::RecordLevel(_lv), __VA_ARGS__)
platform::Logger::Log
void Log(Level level, _fCaller &&f, _tParams &&...args)
Definition: Debug.h:222
platform::Descriptions::RecordLevel
RecordLevel
记录等级。
Definition: YCommon.h:161
platform::FetchCommonLogger
YF_API Logger & FetchCommonLogger()
取公共日志记录器。

使用公共日志记录器记录日志格式字符串。

注解
  支持格式同 std::fprintf 。
  使用 FetchCommonLogger 保证串行输出。

自从
  build 498

在文件 Debug.h 第 270 行定义.

#define YF_Trace | ( |  | _lv,
|  |  | ...
| ) |  |

值:
YCL_Log(_lv, [&]{ \
return platform::LogWithSource(__FILE__, __LINE__, __VA_ARGS__); \
})
platform::LogWithSource
YF_API string LogWithSource(const char *, int, const char *,...) ynothrow
YCL_Log
#define YCL_Log(_lv,...)
使用公共日志记录器记录日志格式字符串。
Definition: Debug.h:270

YCLib 默认调试跟踪。

注解
  无异常抛出。

自从
  build 724

在文件 Debug.h 第 294 行定义.

参考自 YSLib::Environment::Environment(), YSLib::GUIHost::GUIHost(), YSLib::Environment::~Environment() , 以及 YSLib::GUIHost::~GUIHost().

#define YF_TraceRaw | ( |  | _lv,
|  |  | ...
| ) |  |

值:
YCL_Log(_lv, [&]() -> platform::string { \
using platform::sfmt; \
\
TryRet(sfmt(__VA_ARGS__)) \
CatchRet(..., {}) \
})
TryRet
#define TryRet(...)
指定表达式在 try 块中求值并返回。
Definition: YBaseMacro.h:124
platform::containers::string
basic_string< char > string
Definition: Container.h:101
ystdex::sfmt
auto sfmt(const _tChar *fmt,...) -> decltype(vsfmt(fmt, std::declval< std::va_list >()))
以 C 标准输出格式的输出 std::basic_string 实例的对象。
Definition: string.hpp:1200
CatchRet
#define CatchRet(_ex,...)
指定返回语句作为异常处理器。
Definition: YBaseMacro.h:137
YCL_Log
#define YCL_Log(_lv,...)
使用公共日志记录器记录日志格式字符串。
Definition: Debug.h:270

YFramework 跟踪。

注解
  直接按格式字符串的输出跟踪，不带源代码信息。

自从
  build 724

在文件 Debug.h 第 279 行定义.

参考自 YSLib::TryInvoke().

#define YTraceDe | ( |  | ... | ) |

YCLib 默认调试跟踪。

注解
  使用默认的调试跟踪级别。

参见
  YF_Trace

自从
  build 432

在文件 Debug.h 第 313 行定义.

参考自 YSLib::UI::ActAfter(), YSLib::Drawing::ImagePages::AdjustOffset(), NPL::CheckReducible(), NPL::SXML::ConvertAttributeNodeString(), NPL::SXML::ConvertDocumentNode(), YSLib::DebugTimer::DebugTimer(), YSLib::Shells::Shell::DefShlProc(), YSLib::Devices::InputManager::DispatchInput(), YSLib::IO::EnsureDirectory(), YSLib::Environment::Environment(), NPL::EscapeXML(), platform::FetchLimit(), YSLib::Drawing::FontCache::FontCache(), platform::HDirectory::GetNodeCategory(), YSLib::Devices::InitDSScreen(), YSLib::UI::Styles::InitExStyles(), YSLib::InitializeSystemFontCache(), YReader::ShlReader::LoadBookmarks(), YSLib::LoadComponents(), YReader::ShlReader::LoadGlobalConfiguration(), YSLib::LoadNPLA1File(), YSLib::Drawing::FontCache::LoadTypefaces(), main(), YSLib::IO::MakeNormalizedAbsolute(), YSLib::Application::OnGotMessage(), platform::FileDescriptor::Deleter::operator()(), YSLib::UI::ParseRect(), YSLib::PostQuitMessage(), YSLib::Drawing::ImagePages::Resize(), YReader::ShlReader::SaveBookmarks(), YSLib::SaveConfiguration(), YReader::ShlReader::SaveGlobalConfiguration(), YSLib::UI::FileBox::SetPath(), NPL::A1::SetupTraceDepth(), YSLib::UI::Styles::StyleMap::Switch(), YSLib::Drawing::ImagePages::SwitchPage(), YSLib::TraceForOutermost(), YSLib::UI::HexViewArea::UpdateData(), YSLib::UI::BorderResizer::Wrap(), YSLib::Drawing::Zoom(), YSLib::Drawing::ImagePages::ZoomByRatio(), YSLib::Drawing::ImagePages::ZoomTo(), YSLib::Application::~Application() , 以及 YSLib::DebugTimer::~DebugTimer().