274c12fc56
* Streams: string stream * String stream: updated insert/delete api * Streams: generic stream interface and string stream implementation * Streams: helpers for insert and delete_and_insert * FFF: now compatible with streams * MinUnit: introduced tests with arguments * FFF: stream access violation * Streams: copy data between streams * Streams: file stream * FFF: documentation * FFStream: documentation * FFF: alloc as file * MinUnit: support for nested tests * Streams: changed delete_and_insert, now it returns success flag. Added ability dump stream inner parameters and data to cout. * FFF: simplified file open function * Streams: unit tests * FFF: tests * Streams: declare cache_size constant as define, to allow variable modified arrays * FFF: lib moved to a separate folder * iButton: new FFF * RFID: new FFF * Animations: new FFF * IR: new FFF * NFC: new FFF * Flipper file format: delete lib * U2F: new FFF * Subghz: new FFF and streams * Streams: read line * Streams: split * FuriCore: implement memset with extra asserts * FuriCore: implement extra heap asserts without inventing memset * Scene manager: protected access to the scene id stack with a size check * NFC worker: dirty fix for issue where hal_nfc was busy on app start * Furi: update allocator to erase memory on allocation. Replace furi_alloc with malloc. * FuriCore: cleanup memmgr code. * Furi HAL: furi_hal_init is split into critical and non-critical parts. The critical part is currently clock and console. * Memmgr: added ability to track allocations and deallocations through console. * FFStream: some speedup * Streams, FF: minor fixes * Tests: restore * File stream: a slightly more thread-safe version of file_stream_delete_and_insert Co-authored-by: Aleksandr Kutuzov <alleteam@gmail.com>
336 lines
9.2 KiB
C
336 lines
9.2 KiB
C
#pragma once
|
|
#include <stdlib.h>
|
|
#include <stdint.h>
|
|
#include <stdbool.h>
|
|
#include <mlib/m-string.h>
|
|
#include <storage/storage.h>
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
typedef struct Stream Stream;
|
|
|
|
typedef enum {
|
|
StreamOffsetFromCurrent,
|
|
StreamOffsetFromStart,
|
|
StreamOffsetFromEnd,
|
|
} StreamOffset;
|
|
|
|
typedef bool (*StreamWriteCB)(Stream* stream, const void* context);
|
|
|
|
/**
|
|
* Free Stream
|
|
* @param stream Stream instance
|
|
*/
|
|
void stream_free(Stream* stream);
|
|
|
|
/**
|
|
* Clean (empty) Stream
|
|
* @param stream Stream instance
|
|
*/
|
|
void stream_clean(Stream* stream);
|
|
|
|
/**
|
|
* Indicates that the rw pointer is at the end of the stream
|
|
* @param stream Stream instance
|
|
* @return true if rw pointer is at the end of the stream
|
|
* @return false if rw pointer is not at the end of the stream
|
|
*/
|
|
bool stream_eof(Stream* stream);
|
|
|
|
/**
|
|
* Moves the rw pointer.
|
|
* @param stream Stream instance
|
|
* @param offset how much to move the pointer
|
|
* @param offset_type starting from what
|
|
* @return true
|
|
* @return false
|
|
*/
|
|
bool stream_seek(Stream* stream, int32_t offset, StreamOffset offset_type);
|
|
|
|
/**
|
|
* Gets the value of the rw pointer
|
|
* @param stream Stream instance
|
|
* @return size_t value of the rw pointer
|
|
*/
|
|
size_t stream_tell(Stream* stream);
|
|
|
|
/**
|
|
* Gets the size of the stream
|
|
* @param stream Stream instance
|
|
* @return size_t size of the stream
|
|
*/
|
|
size_t stream_size(Stream* stream);
|
|
|
|
/**
|
|
* Write N bytes to the stream
|
|
* @param stream Stream instance
|
|
* @param data data to write
|
|
* @param size size of data to be written
|
|
* @return size_t how many bytes was written
|
|
*/
|
|
size_t stream_write(Stream* stream, const uint8_t* data, size_t size);
|
|
|
|
/**
|
|
* Read N bytes from stream
|
|
* @param stream Stream instance
|
|
* @param data data to be read
|
|
* @param count size of data to be read
|
|
* @return size_t how many bytes was read
|
|
*/
|
|
size_t stream_read(Stream* stream, uint8_t* data, size_t count);
|
|
|
|
/**
|
|
* Delete N chars from the stream and write data by calling write_callback(context)
|
|
* @param stream Stream instance
|
|
* @param delete_size size of data to be deleted
|
|
* @param write_callback write callback
|
|
* @param context write callback context
|
|
* @return true if the operation was successful
|
|
* @return false on error
|
|
*/
|
|
bool stream_delete_and_insert(
|
|
Stream* stream,
|
|
size_t delete_size,
|
|
StreamWriteCB write_callback,
|
|
const void* context);
|
|
|
|
/********************************** Some random helpers starts here **********************************/
|
|
|
|
/**
|
|
* Read line from a stream (supports LF and CRLF line endings)
|
|
* @param stream
|
|
* @param str_result
|
|
* @return true
|
|
* @return false
|
|
*/
|
|
bool stream_read_line(Stream* stream, string_t str_result);
|
|
|
|
/**
|
|
* Moves the rw pointer to the start
|
|
* @param stream Stream instance
|
|
*/
|
|
bool stream_rewind(Stream* stream);
|
|
|
|
/**
|
|
* Write char to the stream
|
|
* @param stream Stream instance
|
|
* @param c char value
|
|
* @return size_t how many bytes was written
|
|
*/
|
|
size_t stream_write_char(Stream* stream, char c);
|
|
|
|
/**
|
|
* Write string to the stream
|
|
* @param stream Stream instance
|
|
* @param string string value
|
|
* @return size_t how many bytes was written
|
|
*/
|
|
size_t stream_write_string(Stream* stream, string_t string);
|
|
|
|
/**
|
|
* Write const char* to the stream
|
|
* @param stream Stream instance
|
|
* @param string c-string value
|
|
* @return size_t how many bytes was written
|
|
*/
|
|
size_t stream_write_cstring(Stream* stream, const char* string);
|
|
|
|
/**
|
|
* Write formatted string to the stream
|
|
* @param stream Stream instance
|
|
* @param format
|
|
* @param ...
|
|
* @return size_t how many bytes was written
|
|
*/
|
|
size_t stream_write_format(Stream* stream, const char* format, ...);
|
|
|
|
/**
|
|
* Write formatted string to the stream, va_list version
|
|
* @param stream Stream instance
|
|
* @param format
|
|
* @param args
|
|
* @return size_t how many bytes was written
|
|
*/
|
|
size_t stream_write_vaformat(Stream* stream, const char* format, va_list args);
|
|
|
|
/**
|
|
* Insert N chars to the stream, starting at the current pointer.
|
|
* Data will be inserted, not overwritteт, so the stream will be increased in size.
|
|
* @param stream Stream instance
|
|
* @param data data to be inserted
|
|
* @param size size of data to be inserted
|
|
* @return true if the operation was successful
|
|
* @return false on error
|
|
*/
|
|
bool stream_insert(Stream* stream, const uint8_t* data, size_t size);
|
|
|
|
/**
|
|
* Insert char to the stream
|
|
* @param stream Stream instance
|
|
* @param c char value
|
|
* @return true if the operation was successful
|
|
* @return false on error
|
|
*/
|
|
bool stream_insert_char(Stream* stream, char c);
|
|
|
|
/**
|
|
* Insert string to the stream
|
|
* @param stream Stream instance
|
|
* @param string string value
|
|
* @return true if the operation was successful
|
|
* @return false on error
|
|
*/
|
|
bool stream_insert_string(Stream* stream, string_t string);
|
|
|
|
/**
|
|
* Insert const char* to the stream
|
|
* @param stream Stream instance
|
|
* @param string c-string value
|
|
* @return true if the operation was successful
|
|
* @return false on error
|
|
*/
|
|
bool stream_insert_cstring(Stream* stream, const char* string);
|
|
|
|
/**
|
|
* Insert formatted string to the stream
|
|
* @param stream Stream instance
|
|
* @param format
|
|
* @param ...
|
|
* @return true if the operation was successful
|
|
* @return false on error
|
|
*/
|
|
bool stream_insert_format(Stream* stream, const char* format, ...);
|
|
|
|
/**
|
|
* Insert formatted string to the stream, va_list version
|
|
* @param stream Stream instance
|
|
* @param format
|
|
* @param args
|
|
* @return true if the operation was successful
|
|
* @return false on error
|
|
*/
|
|
bool stream_insert_vaformat(Stream* stream, const char* format, va_list args);
|
|
|
|
/**
|
|
* Delete N chars from the stream and insert char to the stream
|
|
* @param stream Stream instance
|
|
* @param delete_size size of data to be deleted
|
|
* @param c char value
|
|
* @return true if the operation was successful
|
|
* @return false on error
|
|
*/
|
|
bool stream_delete_and_insert_char(Stream* stream, size_t delete_size, char c);
|
|
|
|
/**
|
|
* Delete N chars from the stream and insert string to the stream
|
|
* @param stream Stream instance
|
|
* @param delete_size size of data to be deleted
|
|
* @param string string value
|
|
* @return true if the operation was successful
|
|
* @return false on error
|
|
*/
|
|
bool stream_delete_and_insert_string(Stream* stream, size_t delete_size, string_t string);
|
|
|
|
/**
|
|
* Delete N chars from the stream and insert const char* to the stream
|
|
* @param stream Stream instance
|
|
* @param delete_size size of data to be deleted
|
|
* @param string c-string value
|
|
* @return true if the operation was successful
|
|
* @return false on error
|
|
*/
|
|
bool stream_delete_and_insert_cstring(Stream* stream, size_t delete_size, const char* string);
|
|
|
|
/**
|
|
* Delete N chars from the stream and insert formatted string to the stream
|
|
* @param stream Stream instance
|
|
* @param delete_size size of data to be deleted
|
|
* @param format
|
|
* @param ...
|
|
* @return true if the operation was successful
|
|
* @return false on error
|
|
*/
|
|
bool stream_delete_and_insert_format(Stream* stream, size_t delete_size, const char* format, ...);
|
|
|
|
/**
|
|
* Delete N chars from the stream and insert formatted string to the stream, va_list version
|
|
* @param stream Stream instance
|
|
* @param delete_size size of data to be deleted
|
|
* @param format
|
|
* @param args
|
|
* @return true if the operation was successful
|
|
* @return false on error
|
|
*/
|
|
bool stream_delete_and_insert_vaformat(
|
|
Stream* stream,
|
|
size_t delete_size,
|
|
const char* format,
|
|
va_list args);
|
|
|
|
/**
|
|
* Remove N chars from the stream, starting at the current pointer.
|
|
* The size may be larger than stream size, the stream will be cleared from current rw pointer to the end.
|
|
* @param stream Stream instance
|
|
* @param size how many chars need to be deleted
|
|
* @return true if the operation was successful
|
|
* @return false on error
|
|
*/
|
|
bool stream_delete(Stream* stream, size_t size);
|
|
|
|
/**
|
|
* Copy data from one stream to another. Data will be copied from current rw pointer and to current rw pointer.
|
|
* @param stream_from
|
|
* @param stream_to
|
|
* @param size
|
|
* @return size_t
|
|
*/
|
|
size_t stream_copy(Stream* stream_from, Stream* stream_to, size_t size);
|
|
|
|
/**
|
|
* Copy data from one stream to another. Data will be copied from start of one stream and to start of other stream.
|
|
* @param stream_from
|
|
* @param stream_to
|
|
* @return size_t
|
|
*/
|
|
size_t stream_copy_full(Stream* stream_from, Stream* stream_to);
|
|
|
|
/**
|
|
* Splits one stream into two others. The original stream will remain untouched.
|
|
* @param stream
|
|
* @param stream_left
|
|
* @param stream_right
|
|
* @return true
|
|
* @return false
|
|
*/
|
|
bool stream_split(Stream* stream, Stream* stream_left, Stream* stream_right);
|
|
|
|
/**
|
|
* Loads data to the stream from a file. Data will be loaded to the current RW pointer. RW pointer will be moved to the end of the stream.
|
|
* @param stream Stream instance
|
|
* @param storage
|
|
* @param path
|
|
* @return size_t
|
|
*/
|
|
size_t stream_load_from_file(Stream* stream, Storage* storage, const char* path);
|
|
|
|
/**
|
|
* Writes data from a stream to a file. Data will be saved starting from the current RW pointer. RW pointer will be moved to the end of the stream.
|
|
* @param stream Stream instance
|
|
* @param storage
|
|
* @param path
|
|
* @param mode
|
|
* @return size_t
|
|
*/
|
|
size_t stream_save_to_file(Stream* stream, Storage* storage, const char* path, FS_OpenMode mode);
|
|
|
|
/**
|
|
* Dump stream inner data (size, RW positiot, content)
|
|
* @param stream Stream instance
|
|
*/
|
|
void stream_dump_data(Stream* stream);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif |