|
VLink
2.3.0
A high-performance communication middleware
|
Pure-virtual interface that every shared-library logger backend implements. 更多...
#include <logger_plugin_interface.h>
Public 成员函数 | |
| virtual bool | init (std::string_view app_name) noexcept=0 |
| Initialises the backend immediately after the plugin instance is constructed. 更多... | |
| virtual bool | log (int level, std::string_view str) noexcept=0 |
| Writes a single record to the backend. 更多... | |
| virtual void | flush () noexcept |
Drains records accepted by log before this call. 更多... | |
Protected 成员函数 | |
| LoggerPluginInterface ()=default | |
| virtual | ~LoggerPluginInterface ()=default |
Pure-virtual interface that every shared-library logger backend implements.
Concrete subclasses use VLINK_PLUGIN_REGISTER internally to expose their factory and destructor functions to the Plugin loader. Instances are owned by the host application for the duration of the plugin handle. When selected through VLINK_LOG_PLUGIN, init runs after the host Logger is constructed and supports same-thread Logger re-entry, so implementations may create VLink communication nodes there. Other threads can continue logging to the console while initialisation is in progress, but their records are not sent to the plugin.
|
protecteddefault |
|
protectedvirtualdefault |
|
inlinevirtualnoexcept |
Drains records accepted by log before this call.
Returns only after plugin-owned asynchronous work for earlier records has completed. A synchronous implementation can use the default no-op.
|
pure virtualnoexcept |
Initialises the backend immediately after the plugin instance is constructed.
| app_name | Calling application name; may inform log labels or file paths. |
true on success; false to indicate the plugin must not be used further.
|
pure virtualnoexcept |
Writes a single record to the backend.
Implementations should be non-blocking; str remains valid only for the duration of the call. The host may call this method concurrently. Logs emitted synchronously by this method or its dependencies are not forwarded back into the same plugin.
| level | Severity using vlink::Logger::Level values. |
| str | Fully formatted record. |
true on success; false to indicate a write error. The global Logger does not retry or redirect a failed plugin write.