Mutable cached generator for short formatted timestamps. 更多...

#include <cached_timestamp.h>

vlink::CachedTimestamp 的协作图:

Public 成员函数
	CachedTimestamp ()
	Constructs the generator with an empty internal cache. 更多...

	~CachedTimestamp ()
	Destructor. 更多...

std::string_view	get (const char *format="%02d-%02d %02d:%02d:%02d.%03d", bool use_utc=false)
	Returns a view of the current formatted timestamp. 更多...

详细描述

Mutable cached generator for short formatted timestamps.

Holds a 32-byte buffer protected by a mutex plus an atomic last-second counter so concurrent get calls share a single formatted prefix and only the millisecond suffix is rewritten. The first call seeds the cache; subsequent same-second calls patch only the trailing three characters in place.

构造及析构函数说明

◆ CachedTimestamp()

vlink::CachedTimestamp::CachedTimestamp ( )

Constructs the generator with an empty internal cache.

The cache is populated lazily on the first get call.

◆ ~CachedTimestamp()

vlink::CachedTimestamp::~CachedTimestamp ( )

Destructor.

成员函数说明

◆ get()

std::string_view vlink::CachedTimestamp::get	(	const char *	format = `"%02d-%02d %02d:%02d:%02d.%03d"`,
		bool	use_utc = `false`
	)

Returns a view of the current formatted timestamp.

The returned view points into the internal 32-byte buffer. It is invalidated by the next call to get on any thread sharing this instance. The format must end with a 3-digit millisecond field because the cache patches the last three bytes in place; the entire formatted string must fit within 31 characters. Switching format or use_utc forces a full reformat on the next second boundary.

参数

format	`snprintf` format consuming six `int` arguments in this order: month, day, hour, minute, second, milliseconds. Default: `"%02d-%02d @c %02d:%02d:%02d.%03d"`.
use_utc	`true` for UTC formatting; `false` for local time. Default: `false`.

返回: std::string_view over the rendered timestamp.

该类的文档由以下文件生成: