From c2eaddc457b27f181725b9f8dfcd97aa9fdbc82d Mon Sep 17 00:00:00 2001 From: Amlal El Mahrouss Date: Sat, 7 Mar 2026 11:25:38 +0100 Subject: [FEAT] Buffered and Unbuffered stream types. Signed-off-by: Amlal El Mahrouss --- doc/requirements/BufferedStream.md | 19 +++++++++++++++++++ doc/requirements/UnbufferedStream.md | 19 +++++++++++++++++++ src/kernel/NeKit/Stream.h | 10 +++++++++- 3 files changed, 47 insertions(+), 1 deletion(-) create mode 100644 doc/requirements/BufferedStream.md create mode 100644 doc/requirements/UnbufferedStream.md diff --git a/doc/requirements/BufferedStream.md b/doc/requirements/BufferedStream.md new file mode 100644 index 00000000..1ac01a0f --- /dev/null +++ b/doc/requirements/BufferedStream.md @@ -0,0 +1,19 @@ +# BufferedStream + +## Abstract: + +One type that has to satisfy a BufferedStream operator and type. + +## Rationale: + +- HPC systems. +- I/O systems. +- HFT systems. + +## Example: + +```cpp +BStream; +``` + +BOperator must not flush at all times, but have the option to. diff --git a/doc/requirements/UnbufferedStream.md b/doc/requirements/UnbufferedStream.md new file mode 100644 index 00000000..80536b44 --- /dev/null +++ b/doc/requirements/UnbufferedStream.md @@ -0,0 +1,19 @@ +# BufferedStream + +## Abstract: + +One type that has to satisfy an unbuffered Stream operator and type. + +## Rationale: + +- Fast and direct-flush operations. +- High-Throughput systems. + +## Example: + +```cpp +UBStream; +``` + +UBOperator must flush at all times! + diff --git a/src/kernel/NeKit/Stream.h b/src/kernel/NeKit/Stream.h index d69df6d0..b24038c1 100644 --- a/src/kernel/NeKit/Stream.h +++ b/src/kernel/NeKit/Stream.h @@ -1,4 +1,4 @@ -// Copyright 2024-2025, Amlal El Mahrouss (amlal@nekernel.org) +// Copyright 2024-2026, Amlal El Mahrouss (amlal@nekernel.org) // Licensed under the Apache License, Version 2.0 (see LICENSE file) // Official repository: https://github.com/ne-foss-org/nekernel @@ -9,6 +9,7 @@ #include namespace Kernel { + template class Stream final { public: @@ -40,6 +41,13 @@ class Stream final { Ref fStream; Ref fKind; }; + +template +using UnbufferedStream = Stream; + +template +using BufferedStream = Stream; + } // namespace Kernel #endif -- cgit v1.2.3