SimpleNamedPipe

SimpleNamedPipe — легковесная библиотека C++ для создания и управления асинхронными серверами именованных каналов в Windows.

Проект распространяется под лицензией MIT. Полный текст лицензии см. в файле LICENSE.

Основные возможности

асинхронная обработка клиентов через IO Completion Port;
работа либо в отдельном потоке, либо блокирующе в текущем (параметр start());
поддержка до 256 одновременных клиентов;
очередь отправки с ограничением размера и количества сообщений;
уведомления о событиях через колбэки или класс ServerEventHandler;
лёгкий клиент для MQL5 с опциональными глобальными обратными вызовами.
клиент MQL5 выполняет чтение/запись синхронно, обновление через метод update() например в таймере.

Быстрый старт

Простейший сервер

#include "SimpleNamedPipe/NamedPipeServer.hpp"
using namespace SimpleNamedPipe;

int main() {
    NamedPipeServer server({"ExamplePipe"});

    server.on_message = [&server](int id, const std::string& msg) {
        server.send_to(id, "Echo: " + msg);
    };

    server.start(); // запускает сервер в отдельном потоке
    std::cin.get(); // ожидание Enter
    server.stop();
}

Простейший клиент MQL5

#include <SimpleNamedPipe\NamedPipeClient.mqh>

NamedPipeClient pipe;

int OnInit() {
    pipe.open("ExamplePipe");
    EventSetMillisecondTimer(10);
    return INIT_SUCCEEDED;
}

void OnDeinit(const int reason) {
    EventKillTimer();
}

void OnTimer() {
    pipe.update();
    if(pipe.connected())
        pipe.write("ping");
}

Установка

Установите CMake и компилятор (Visual Studio или MinGW).
Для сборки библиотеки и примеров выполните build_all.bat (или build_all_mingw.bat для MinGW).
Скрипт install_mql5.bat копирует файлы из каталога MQL5 во все найденные терминалы MetaTrader 5.

Примеры

Исходники примеров расположены в каталоге examples.

callback_example.cpp демонстрирует работу сервера с отдельными коллбэками (on_connected, on_message и т.д.).
universal_event_example.cpp показывает аналогичную логику, но используя единый обработчик on_event.

Полезные ссылки

Лицензия

SimpleNamedPipe распространяется по лицензии MIT. Подробнее см. файл LICENSE.

FilesExpand file tree

README-RU.md

Latest commit

History