unleashed-firmware/lib/toolbox/path.h
Sergey Gavrilov 4bf29827f8
M*LIB: non-inlined strings, FuriString primitive (#1795)
* Quicksave 1
* Header stage complete
* Source stage complete
* Lint & merge fixes
* Includes
* Documentation step 1
* FBT: output free size considering BT STACK
* Documentation step 2
* py lint
* Fix music player plugin
* unit test stage 1: string allocator, mem, getters, setters, appends, compare, search.
* unit test: string equality
* unit test: string replace
* unit test: string start_with, end_with
* unit test: string trim
* unit test: utf-8
* Rename
* Revert fw_size changes
* Simplify CLI backspace handling
* Simplify CLI character insert
* Merge fixes
* Furi: correct filenaming and spelling
* Bt: remove furi string include

Co-authored-by: Aleksandr Kutuzov <alleteam@gmail.com>
2022-10-06 00:15:23 +09:00

79 lines
1.9 KiB
C

#pragma once
#include <furi.h>
#ifdef __cplusplus
extern "C" {
#endif
/**
* @brief Extract filename without extension from path.
*
* @param path path string
* @param filename output filename string. Must be initialized before.
*/
void path_extract_filename_no_ext(const char* path, FuriString* filename);
/**
* @brief Extract filename string from path.
*
* @param path path string
* @param filename output filename string. Must be initialized before.
* @param trim_ext true - get filename without extension
*/
void path_extract_filename(FuriString* path, FuriString* filename, bool trim_ext);
/**
* @brief Extract file extension from path.
*
* @param path path string
* @param ext output extension string
* @param ext_len_max maximum extension string length
*/
void path_extract_extension(FuriString* path, char* ext, size_t ext_len_max);
/**
* @brief Extract last path component
*
* @param path path string
* @param filename output string. Must be initialized before.
*/
void path_extract_basename(const char* path, FuriString* basename);
/**
* @brief Extract path, except for last component
*
* @param path path string
* @param filename output string. Must be initialized before.
*/
void path_extract_dirname(const char* path, FuriString* dirname);
/**
* @brief Appends new component to path, adding path delimiter
*
* @param path path string
* @param suffix path part to apply
*/
void path_append(FuriString* path, const char* suffix);
/**
* @brief Appends new component to path, adding path delimiter
*
* @param path first path part
* @param suffix second path part
* @param out_path output string to combine parts into. Must be initialized
*/
void path_concat(const char* path, const char* suffix, FuriString* out_path);
/**
* @brief Check that path contains only ascii characters
*
* @param path
* @return true
* @return false
*/
bool path_contains_only_ascii(const char* path);
#ifdef __cplusplus
}
#endif