dynstring.h

Go to the documentation of this file.

//
// Created by MacBook on 18.10.2024.
//
 
#ifndef CLIBS_DYNSTRING_H
#define CLIBS_DYNSTRING_H
 
#include "../headers/attributes.h" /* Constructor */
 
#include <stdarg.h>
#include <stddef.h>
#include <sys/types.h>
 
 
typedef struct dynamic_string DynString;
 
 
/* ==== Constructors/Destructors ==== */
Constructor DynString *dynstr_init( void );
Constructor DynString *dynstr_init_cap( size_t cap );
Constructor DynString *dynstr_init_as( const char * );

void dynstr_destroy( DynString * );
 
 
/* ==== Modifiers ==== */
ssize_t dynstr_append( DynString *, const char *app );
ssize_t dynstr_appendn( DynString *, const char *app, size_t len );
PrintfLike( 2, 3 ) ssize_t dynstr_appendf( DynString *, const char *fmt, ... );
ssize_t dynstr_vappendf( DynString *, const char *fmt, va_list vargs );

ssize_t dynstr_prepend( DynString *, const char * );
ssize_t dynstr_prependn( DynString *, const char *s, size_t len );
PrintfLike( 2, 3 ) ssize_t dynstr_prependf( DynString *, const char *fmt, ... );
ssize_t dynstr_vprependf( DynString *, const char *fmt, va_list vargs );

int dynstr_slice( DynString *, size_t start_idx, ssize_t end_idx );
int dynstr_slice_e( DynString *, ssize_t end_idx );
int dynstr_slice_s( DynString *, size_t start_idx );

int dynstr_reset( DynString * );

int dynstr_set( DynString *, const char *string );

int dynstr_set_at( DynString *dynstr, size_t idx, char c );
 
 
/* ==== Getters ==== */
UseResult char *dynstr_data_copy( const DynString * );
const char *dynstr_data( const DynString * );
size_t dynstr_len( const DynString * );
 
#endif //CLIBS_DYNSTRING_H