cpu_profiler_guard.h 文件参考

Stack-based RAII bracket that pairs every CpuProfiler::begin with a guaranteed end. 更多...

#include "./macros.h"

cpu_profiler_guard.h 的引用(Include)关系图:

此图展示该文件直接或间接的被哪些文件引用了:

浏览源代码.

类
class	vlink::CpuProfilerGuard
	Scope guard that opens and closes a CpuProfiler active interval. 更多...

命名空间
	vlink

详细描述

Stack-based RAII bracket that pairs every CpuProfiler::begin with a guaranteed end.

CpuProfilerGuard ties the begin / end pair of a CpuProfiler to scope lifetime so the active interval closes even when the protected region exits through an exception.

RAII pattern

*   scope entry +---------------------------+ scope exit
*   ----------> | CpuProfilerGuard guard(p) | ---------->
*               +-----------+---------------+
*                           | ctor: p->begin()
*                           v
*                       active interval
*                           |
*                           | dtor: p->end()
*                           v
*                       interval closed
* 

The guard accepts a nullptr profiler so call sites can be guarded uniformly while a higher-level switch (typically CpuProfiler::is_global_enabled) decides whether the work is worth measuring.

Example

vlink::CpuProfiler profiler;
 
void process_frame() {
  vlink::CpuProfilerGuard guard(&profiler);   // profiler.begin()
  do_frame_work();
}                                             // profiler.end() on scope exit
 
const double utilisation = profiler.get();

注解

Non-copyable and non-movable; the guard must live on the stack of the protected region.