mirror of
https://github.com/flipperdevices/flipperzero-firmware.git
synced 2025-12-12 20:59:50 +04:00
48 lines
1.0 KiB
C
48 lines
1.0 KiB
C
|
/**
|
||
|
|
* @file str_buffer.h
|
||
|
|
*
|
||
|
|
* Allows you to create an owned clone of however many strings that you need,
|
||
|
|
* then free all of them at once. Essentially the simplest possible append-only
|
||
|
|
* unindexable array of owned C-style strings.
|
||
|
|
*/
|
||
|
|
#pragma once
|
||
|
|
|
||
|
|
#include <furi.h>
|
||
|
|
|
||
|
|
#ifdef __cplusplus
|
||
|
|
extern "C" {
|
||
|
|
#endif
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @brief StrBuffer instance
|
||
|
|
*
|
||
|
|
* Place this struct directly wherever you want, it doesn't have to be `alloc`ed
|
||
|
|
* and `free`d.
|
||
|
|
*/
|
||
|
|
typedef struct {
|
||
|
|
char** owned_strings;
|
||
|
|
size_t n_owned_strings;
|
||
|
|
} StrBuffer;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @brief Makes a owned duplicate of the provided string
|
||
|
|
*
|
||
|
|
* @param[in] buffer StrBuffer instance
|
||
|
|
* @param[in] str Input C-style string
|
||
|
|
*
|
||
|
|
* @returns C-style string that contains to be valid event after `str` becomes
|
||
|
|
* invalid
|
||
|
|
*/
|
||
|
|
const char* str_buffer_make_owned_clone(StrBuffer* buffer, const char* str);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @brief Clears all owned duplicates
|
||
|
|
*
|
||
|
|
* @param[in] buffer StrBuffer instance
|
||
|
|
*/
|
||
|
|
void str_buffer_clear_all_clones(StrBuffer* buffer);
|
||
|
|
|
||
|
|
#ifdef __cplusplus
|
||
|
|
}
|
||
|
|
#endif
|