This repository has been archived on 2023-09-28. You can view files and clone it, but cannot push or open issues or pull requests.
homepage/content/projects/noxos/docs/codebase/utils/stream.h.md

31 lines
1.5 KiB
Markdown

---
title: "stream.h"
date: 2023-04-20T22:15:05+02:00
summary: "Streams are cycled buffers, that have __one__ input and __one__ output."
---
Streams are cycled buffers, that have __one__ input and __one__ output.
# `stream_T` - struct
| Name | Type | Description |
|--------------|----------|----------------------------------------------------------------------------------|
| buffer | uint8_t* | The buffer where all the streams data is stored in. |
| size | uint32_t | The size of _buffer_ in bytes. |
| pos_sender | uint32_t | The senders (input) position in the buffer. |
| pos_receiver | uint32_t | The receivers (output) position in the buffer. This is always behind the sender. |
# `stream_alloc(size)` - function (stream_T*)
Allocates and returns a new stream, with a buffer of size **_size_**.
# `stream_destruct(stream)` - function (void)
Frees the resources of a stream.
# `stream_write(stream, buffer_in, n)` - function (uint32_t)
Writes at most **_n_** bytes from **_buffer_in_** into **_stream_**.
Returns the amount of bytes, that where actually written into the stream.
# `stream_read(stream, buffer_out, n)` - function (uint32_t)
Reads at most **_n_** bytes from **_stream_** into **_buffer_out_**.
Returns the amount of bytes, that where actually read from the stream.