Demo: Files and Asynchronous Logging

Demonstrates text-file operations, binary-safe copying, and logging lifecycle without arbitrary sleeps.

1. Example Scope

The page mirrors the repository source, CMake target, and current API, with English comments for the relevant calls.

2. Build and Run

cmake --build build --target sttnet_file_logging --parallel
./build/examples/sttnet_file_logging

3. Validation

./build/examples/sttnet_file_logging

Expected: Creates a configuration and its copy, prints the content and dropped-log count, and drains queued records during logger destruction.

4. Complete Source

#include <sttnet.h>

#include <iostream>

int main()
{
    using stt::file::File;
    using stt::file::FileTool;
    using stt::file::LogFile;

    // createDir() returns false when creation fails; an existing directory may
    // also make it return false, so inspect the path when this matters.
    (void)FileTool::createDir("runtime");

    // File provides thread-safe text and binary operations. openFile() can create
    // missing parent directories when creation is enabled by the API.
    File config;
    if(!config.openFile("runtime/example.conf"))
        return 1;
    config.deleteAll();
    config.appendLine("port=8080");
    config.appendLine("workers=4");
    std::string all;
    config.readAll(all);
    std::cout << "configuration:\n" << all << '\n';
    config.closeFile();

    // FileTool::copy() now copies raw bytes. It returns false when either file
    // cannot be opened or when the write does not complete successfully.
    if(!FileTool::copy("runtime/example.conf","runtime/example.conf.copy"))
        return 2;

    // LogFile owns a bounded asynchronous queue. Keep the object alive until all
    // producer threads have stopped. Its destructor drains queued records before
    // closing; an arbitrary sleep does not provide the same lifecycle guarantee.
    {
        LogFile log(8192);
        if(!log.openFile("runtime/example.log"))
            return 3;
        log.writeLog("service started");
        log.writeLog("configuration loaded");
        std::cout << "dropped logs: " << log.getDroppedLogCount() << '\n';
    }
    return 0;
}