Nilorea Library
C utilities for networking, threading, graphics
Loading...
Searching...
No Matches
STRINGS: replacement to char *strings with dynamic resizing and boundary checking

Data Structures

struct  N_STR
 A box including a string and his lenght. More...
 

Macros

#define free_nstr(__ptr)
 free a N_STR structure and set the pointer to NULL
 
#define local_strdup(__src_)
 Do tar(1) matching rules, which ignore a trailing slash?
 
#define n_remove_ending_cr(__nstr_var)
 Remove carriage return (backslash r) if there is one in the last position of the string.
 
#define n_replace_cr(__nstr_var, __replacement)
 Find and replace all occurences of carriage return (backslash r) in the string.
 
#define nstrcat(__nstr_dst, __nstr_src)
 Macro to quickly concatenate two N_STR.
 
#define nstrcat_bytes(__nstr_dst, __void_src)    nstrcat_bytes_ex(&(__nstr_dst), __void_src, strlen(__void_src))
 Macro to quickly concatenate a '\0' ended byte stream to a N_STR.
 
#define nstrprintf(__nstr_var, __format, ...)    nstrprintf_ex(&(__nstr_var), (__format), ##__VA_ARGS__)
 Macro to quickly allocate and sprintf to N_STR.
 
#define nstrprintf_cat(__nstr_var, __format, ...)    nstrprintf_cat_ex(&(__nstr_var), (__format), ##__VA_ARGS__)
 Macro to quickly allocate and sprintf and cat to a N_STR.
 
#define strprintf(__n_var, ...)
 Macro to quickly allocate and sprintf to a char.
 
#define WILDMAT_ABORT   -2
 Abort code to sped up pattern matching.
 
#define WILDMAT_NEGATE_CLASS   '^'
 What character marks an inverted character class?
 

Typedefs

typedef size_t NSTRBYTE
 N_STR base unit.
 

Functions

int _free_nstr (N_STR **ptr)
 Free a N_STR structure and set the pointer to NULL.
 
N_STRchar_to_nstr (const char *src)
 Convert a char into a N_STR, short version.
 
int char_to_nstr_ex (const char *from, NSTRBYTE nboct, N_STR **to)
 Convert a char into a N_STR, extended version.
 
N_STRchar_to_nstr_nocopy (char *src)
 Convert a char into a N_STR, direct use of linked source pointer.
 
int char_to_nstr_nocopy_ex (char *from, NSTRBYTE nboct, N_STR **to)
 
int empty_nstr (N_STR *nstr)
 empty a N_STR string
 
N_STRfile_to_nstr (char *filename)
 Load a whole file into a N_STR.
 
int free_nstr_nolog (N_STR **ptr)
 Free a N_STR structure and set the pointer to NULL.
 
void free_nstr_ptr (void *ptr)
 Free a N_STR pointer structure.
 
void free_nstr_ptr_nolog (void *ptr)
 Free a N_STR pointer structure.
 
int free_split_result (char ***tab)
 Free a split result allocated array.
 
char * join (char **splitresult, char *delim)
 join the array into a string
 
N_STRnew_nstr (NSTRBYTE size)
 create a new N_STR string
 
char * nfgets (char *buffer, NSTRBYTE size, FILE *stream)
 try to fgets
 
int nstr_to_fd (N_STR *str, FILE *out, int lock)
 Write a N_STR content into a file.
 
int nstr_to_file (N_STR *n_str, char *filename)
 Write a N_STR content into a file.
 
N_STRnstrcat_bytes_ex (N_STR **dest, void *src, NSTRBYTE size)
 Append data into N_STR using internal N_STR size and cursor position.
 
N_STRnstrcat_ex (N_STR **dest, void *src, NSTRBYTE size, int resize_flag)
 
N_STRnstrdup (N_STR *msg)
 Duplicate a N_STR.
 
N_STRnstrprintf_cat_ex (N_STR **nstr_var, const char *format,...)
 
N_STRnstrprintf_ex (N_STR **nstr_var, const char *format,...)
 
int resize_nstr (N_STR *nstr, size_t size)
 reallocate a nstr internal buffer.
 
int scan_dir (const char *dir, LIST *result, const int recurse)
 Scan a list of directory and return a list of char *file.
 
int scan_dir_ex (const char *dir, const char *pattern, LIST *result, const int recurse, const int mode)
 Scan a list of directory and return a list of char *file.
 
int skipu (char *string, char toskip, NSTRBYTE *iterator, int inc)
 skip until 'toskip' occurence is found from 'iterator' to the next 'toskip' value.
 
int skipw (char *string, char toskip, NSTRBYTE *iterator, int inc)
 skip while 'toskip' occurence is found from 'iterator' to the next non 'toskip' position.
 
char ** split (const char *str, const char *delim, int empty)
 split the strings into a an array of char *pointer , ended by a NULL one.
 
int split_count (char **split_result)
 Count split elements.
 
char * str_replace (const char *string, const char *substr, const char *replacement)
 Replace "substr" by "replacement" inside string taken from http://coding.debuntu.org/c-implementing-str_replace-replace-all-occurrences-substring By Chantra.
 
int str_sanitize (char *string, const char *mask, const char replacement)
 clean a string by replacing evil characteres
 
int str_sanitize_ex (char *string, const NSTRBYTE string_len, const char *mask, const NSTRBYTE masklen, const char replacement)
 clean a string by replacing evil characteres
 
int str_to_int (const char *s, int *i, const int base)
 Helper for string to integer.
 
int str_to_int_ex (const char *s, NSTRBYTE start, NSTRBYTE end, int *i, const int base)
 Helper for string[start to end] to integer.
 
int str_to_int_nolog (const char *s, NSTRBYTE start, NSTRBYTE end, int *i, const int base, N_STR **infos)
 Helper for string[start to end] to integer.
 
int str_to_long (const char *s, long int *i, const int base)
 Helper for string to integer.
 
int str_to_long_ex (const char *s, NSTRBYTE start, NSTRBYTE end, long int *i, const int base)
 Helper for string[start to end] to long integer.
 
int str_to_long_long (const char *s, long long int *i, const int base)
 Helper for string to integer.
 
int str_to_long_long_ex (const char *s, NSTRBYTE start, NSTRBYTE end, long long int *i, const int base)
 Helper for string[start to end] to long long integer.
 
int strcpy_u (char *from, char *to, NSTRBYTE to_size, char split, NSTRBYTE *it)
 Copy from start to dest until from[ iterator ] == split.
 
int strlo (char *string, char *dest)
 Upper case a string.
 
int strup (char *string, char *dest)
 Upper case a string.
 
char * trim (char *s)
 trim and put a \0 at the end, return new char *
 
char * trim_nocopy (char *s)
 trim and zero end the string, WARNING: keep and original pointer to delete the string correctly
 
int wildmat (register const char *text, register const char *p)
 Written by Rich Salz rsalz at osf.org, refurbished by me.
 
int wildmatcase (register const char *text, register const char *p)
 Written by Rich Salz rsalz at osf.org, refurbished by me.
 
int write_and_fit (char **dest, NSTRBYTE *size, NSTRBYTE *written, const char *src)
 concatenate a copy of src of size strlen( src ) to dest, starting at dest[ written ], updating written and size variable, allocation of new blocks of (needed size + 512) if resize is needed.
 
int write_and_fit_ex (char **dest, NSTRBYTE *size, NSTRBYTE *written, const char *src, NSTRBYTE src_size, NSTRBYTE additional_padding)
 concatenate a copy of src of size src_size to dest, starting at dest[ written ], updating written and size variable, allocation of new blocks of (needed size + additional_padding ) if resize is needed.
 

Detailed Description


Data Structure Documentation

◆ N_STR

struct N_STR

A box including a string and his lenght.

Examples
ex_base64.c, ex_common.c, ex_crypto.c, ex_fluid.c, ex_gui.c, ex_gui_particles.c, ex_hash.c, ex_list.c, ex_monolith.c, ex_network.c, ex_network_ssl.c, and ex_nstr.c.

Definition at line 39 of file n_str.h.

+ Collaboration diagram for N_STR:
Data Fields
char * data the string
size_t length length of string (in case we wanna keep information after the 0 end of string value)
size_t written size of the written data inside the string

Macro Definition Documentation

◆ free_nstr

#define free_nstr (   __ptr)
Value:
{ \
if ((*__ptr)) { \
_free_nstr(__ptr); \
} else { \
n_log(LOG_DEBUG, "%s is already NULL", #__ptr); \
} \
}
#define LOG_DEBUG
debug-level messages
Definition n_log.h:64

free a N_STR structure and set the pointer to NULL

Examples
ex_base64.c, ex_common.c, ex_crypto.c, ex_fluid.c, ex_gui.c, ex_gui_particles.c, ex_hash.c, ex_list.c, ex_monolith.c, ex_network.c, ex_network_ssl.c, and ex_nstr.c.

Definition at line 176 of file n_str.h.

◆ local_strdup

#define local_strdup (   __src_)
Value:
({ \
char* __local_strdup_str = NULL; \
size_t __local_strdup_len = strlen((__src_)); \
Malloc(__local_strdup_str, char, __local_strdup_len + 1); \
if (!__local_strdup_str) { \
n_log(LOG_ERR, "Couldn't allocate %d byte for duplicating \"%s\"", (__src_)); \
} else { \
for (size_t __local_strdup_it = 0; __local_strdup_it <= __local_strdup_len; __local_strdup_it++) { \
__local_strdup_str[__local_strdup_it] = (__src_)[__local_strdup_it]; \
} \
} \
__local_strdup_str; \
})
#define LOG_ERR
error conditions
Definition n_log.h:56

Do tar(1) matching rules, which ignore a trailing slash?

local strdup

Definition at line 56 of file n_str.h.

◆ n_remove_ending_cr

#define n_remove_ending_cr (   __nstr_var)
Value:
if (__nstr_var && __nstr_var->data && __nstr_var->data[__nstr_var->written] == '\r') { \
__nstr_var->data[__nstr_var->written] = '\0'; \
__nstr_var->written--; \
}

Remove carriage return (backslash r) if there is one in the last position of the string.

Definition at line 116 of file n_str.h.

◆ n_replace_cr

#define n_replace_cr (   __nstr_var,
  __replacement 
)
Value:
if (__nstr_var && __nstr_var->data && __nstr_var->written > 0) { \
char* __replaced = str_replace(__nstr_var->data, "\r", __replacement); \
if (__replaced) { \
Free(__nstr_var->data); \
__nstr_var->data = __replaced; \
__nstr_var->written = strlen(__nstr_var->data); \
__nstr_var->length = __nstr_var->written + 1; \
} \
}
char * str_replace(const char *string, const char *substr, const char *replacement)
Replace "substr" by "replacement" inside string taken from http://coding.debuntu.org/c-implementing-s...
Definition n_str.c:1341

Find and replace all occurences of carriage return (backslash r) in the string.

Definition at line 123 of file n_str.h.

◆ nstrcat

#define nstrcat (   __nstr_dst,
  __nstr_src 
)
Value:
({ \
N_STR* __nstrcat_ret = NULL; \
if (__nstr_src && __nstr_src->data) { \
__nstrcat_ret = nstrcat_ex(&(__nstr_dst), __nstr_src->data, __nstr_src->written, 1); \
} \
__nstrcat_ret; \
})
A box including a string and his lenght.
Definition n_str.h:39

Macro to quickly concatenate two N_STR.

Examples
ex_monolith.c, and ex_nstr.c.

Definition at line 102 of file n_str.h.

◆ nstrcat_bytes

#define nstrcat_bytes (   __nstr_dst,
  __void_src 
)     nstrcat_bytes_ex(&(__nstr_dst), __void_src, strlen(__void_src))

Macro to quickly concatenate a '\0' ended byte stream to a N_STR.

Definition at line 112 of file n_str.h.

◆ nstrprintf

#define nstrprintf (   __nstr_var,
  __format,
  ... 
)     nstrprintf_ex(&(__nstr_var), (__format), ##__VA_ARGS__)

Macro to quickly allocate and sprintf to N_STR.

Examples
ex_base64.c, ex_crypto.c, ex_fluid.c, ex_gui.c, ex_gui_particles.c, ex_hash.c, ex_list.c, ex_monolith.c, ex_network_ssl.c, and ex_nstr.c.

Definition at line 94 of file n_str.h.

◆ nstrprintf_cat

#define nstrprintf_cat (   __nstr_var,
  __format,
  ... 
)     nstrprintf_cat_ex(&(__nstr_var), (__format), ##__VA_ARGS__)

Macro to quickly allocate and sprintf and cat to a N_STR.

Examples
ex_monolith.c, and ex_nstr.c.

Definition at line 98 of file n_str.h.

◆ strprintf

#define strprintf (   __n_var,
  ... 
)
Value:
({ \
char* __strprintf_ptr = NULL; \
if (!(__n_var)) { \
int __needed = snprintf(NULL, 0, __VA_ARGS__); \
if (__needed > 0) { \
Malloc(__n_var, char, (size_t)__needed + 1) if (__n_var) { \
snprintf(__n_var, (size_t)__needed + 1, __VA_ARGS__); \
__strprintf_ptr = __n_var; \
} \
else { \
n_log(LOG_ERR, "couldn't allocate %s with %d bytes", \
#__n_var, __needed + 1); \
} \
} \
} else { \
n_log(LOG_ERR, "%s is already allocated.", #__n_var); \
} \
__strprintf_ptr; \
})

Macro to quickly allocate and sprintf to a char.

Definition at line 72 of file n_str.h.

◆ WILDMAT_ABORT

#define WILDMAT_ABORT   -2

Abort code to sped up pattern matching.

Special thanks to Lars Mathiesen thori.nosp@m.nn@d.nosp@m.iku.d.nosp@m.k for the ABORT code.

Definition at line 49 of file n_str.h.

◆ WILDMAT_NEGATE_CLASS

#define WILDMAT_NEGATE_CLASS   '^'

What character marks an inverted character class?

Definition at line 51 of file n_str.h.

Typedef Documentation

◆ NSTRBYTE

typedef size_t NSTRBYTE

N_STR base unit.

Definition at line 36 of file n_str.h.

Function Documentation

◆ _free_nstr()

int _free_nstr ( N_STR **  ptr)

Free a N_STR structure and set the pointer to NULL.

Parameters
ptrA N_STR *object to free
Returns
TRUE or FALSE

Definition at line 62 of file n_str.c.

References __n_assert, and FreeNoLog.

◆ char_to_nstr()

N_STR * char_to_nstr ( const char *  src)

Convert a char into a N_STR, short version.

Parameters
srcA char *string to convert
Returns
A N_STR copy of src or NULL

Definition at line 228 of file n_str.c.

References __n_assert, and char_to_nstr_ex().

Referenced by add_strdup_to_msg(), n_vigenere_quick_decode(), and n_vigenere_quick_encode().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ char_to_nstr_ex()

int char_to_nstr_ex ( const char *  from,
NSTRBYTE  nboct,
N_STR **  to 
)

Convert a char into a N_STR, extended version.

Parameters
fromA char *string to convert
nboctThe size to copy, from 1 octet to nboctet (ustrsizez( from ) )
toA N_STR pointer who will be Malloced
Returns
True on success, FALSE on failure ( to will be set to NULL )

Definition at line 205 of file n_str.c.

References __n_assert, _str, Free, LOG_ERR, n_log, and new_nstr().

Referenced by char_to_nstr().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ char_to_nstr_nocopy()

N_STR * char_to_nstr_nocopy ( char *  src)

Convert a char into a N_STR, direct use of linked source pointer.

Parameters
srcA char *string to use
Returns
A N_STR using src or NULL

Definition at line 241 of file n_str.c.

References __n_assert, data, length, new_nstr(), and written.

+ Here is the call graph for this function:

◆ empty_nstr()

int empty_nstr ( N_STR nstr)

empty a N_STR string

Parameters
nstrthe N_STR *str string to empty
Returns
TRUE or FALSE

Definition at line 165 of file n_str.c.

References __n_assert, data, length, and written.

◆ file_to_nstr()

N_STR * file_to_nstr ( char *  filename)

Load a whole file into a N_STR.

Be aware of the NSTRBYTE addressing limit (2GB commonly)

Parameters
filenameThe filename to load inside a N_STR
Returns
A valid N_STR or NULL

Definition at line 260 of file n_str.c.

References __n_assert, data, free_nstr, LOG_DEBUG, LOG_ERR, n_log, new_nstr(), and written.

Referenced by n_gui_load_dialog(), n_kafka_load_config(), n_kafka_new_event_from_file(), n_vigenere_decode_file(), n_vigenere_decode_file_qa(), n_vigenere_encode_file(), and n_vigenere_encode_file_qa().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ free_nstr_nolog()

int free_nstr_nolog ( N_STR **  ptr)

Free a N_STR structure and set the pointer to NULL.

Parameters
ptrA N_STR *object to free
Returns
TRUE or FALSE

Definition at line 76 of file n_str.c.

References FreeNoLog.

◆ free_nstr_ptr()

void free_nstr_ptr ( void *  ptr)

Free a N_STR pointer structure.

Parameters
ptrA N_STR *object to free

Definition at line 49 of file n_str.c.

References data, and FreeNoLog.

Referenced by add_nstrdup_to_msg(), add_nstrptr_to_msg(), add_strdup_to_msg(), n_kafka_poll(), netw_add_msg(), netw_add_msg_ex(), netw_recv_func(), and scan_dir_ex().

+ Here is the caller graph for this function:

◆ free_nstr_ptr_nolog()

void free_nstr_ptr_nolog ( void *  ptr)

Free a N_STR pointer structure.

Parameters
ptrA N_STR *object to free

Definition at line 89 of file n_str.c.

References data, and FreeNoLog.

◆ free_split_result()

int free_split_result ( char ***  tab)

Free a split result allocated array.

Parameters
tabA pointer to a split result to free
Returns
TRUE

Definition at line 970 of file n_str.c.

References Free.

Referenced by load_config_file(), n_kafka_delivery_message_callback(), and split().

+ Here is the caller graph for this function:

◆ join()

char * join ( char **  splitresult,
char *  delim 
)

join the array into a string

Parameters
splitresultthe split result to join
delimThe delimiter, one or more characters
Returns
the joined split result or NULL

Definition at line 990 of file n_str.c.

References Malloc.

Referenced by n_kafka_load_config(), and n_kafka_pooling_thread().

+ Here is the caller graph for this function:

◆ new_nstr()

N_STR * new_nstr ( NSTRBYTE  size)

create a new N_STR string

Parameters
sizeSize of the new string. 0 for no allocation.
Returns
A new allocated N_STR or NULL

Definition at line 180 of file n_str.c.

References __n_assert, data, Free, length, Malloc, and written.

Referenced by char_to_nstr_ex(), char_to_nstr_nocopy(), file_to_nstr(), n_base64_decode(), n_base64_encode(), n_kafka_dump_unprocessed(), n_kafka_load_config(), n_kafka_new(), n_vigenere_get_answer(), n_vigenere_get_question(), n_vigenere_get_rootkey(), nstrdup(), send_net_datas(), unzip_nstr(), and zip_nstr().

+ Here is the caller graph for this function:

◆ nfgets()

char * nfgets ( char *  buffer,
NSTRBYTE  size,
FILE *  stream 
)

try to fgets

Parameters
bufferThe string where to read the file
sizeSize of the string
streamThe file to read
Returns
NULL or the captured string

Definition at line 144 of file n_str.c.

References __n_assert, LOG_ERR, and n_log.

◆ nstr_to_fd()

int nstr_to_fd ( N_STR str,
FILE *  out,
int  lock 
)

Write a N_STR content into a file.

Parameters
strThe N_STR *content to write down
outAn opened FILE *handler
locka write lock will be put if lock = 1
Returns
TRUE or FALSE

Definition at line 336 of file n_str.c.

References __n_assert, data, LOG_ERR, n_log, and written.

Referenced by nstr_to_file().

+ Here is the caller graph for this function:

◆ nstr_to_file()

int nstr_to_file ( N_STR str,
char *  filename 
)

Write a N_STR content into a file.

Parameters
strThe N_STR *content to write down
filenameThe destination filename
Returns
TRUE or FALSE

Definition at line 386 of file n_str.c.

References __n_assert, _str, LOG_DEBUG, LOG_ERR, n_log, nstr_to_fd(), and written.

Referenced by n_kafka_dump_unprocessed(), n_vigenere_decode_file(), n_vigenere_decode_file_qa(), n_vigenere_encode_file(), and n_vigenere_encode_file_qa().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ nstrcat_bytes_ex()

N_STR * nstrcat_bytes_ex ( N_STR **  dest,
void *  data,
NSTRBYTE  size 
)

Append data into N_STR using internal N_STR size and cursor position.

Wrapper to nstrcat_ex, with resize_flag on and a block size one byte higher than size.

Parameters
destThe N_STR **destination (accumulator)
dataThe data to append
sizeThe number of octet of data we want to append in dest
Returns
TRUE or FALSE

Definition at line 1072 of file n_str.c.

References __n_assert, LOG_ERR, and n_log.

◆ nstrcat_ex()

N_STR * nstrcat_ex ( N_STR **  dest,
void *  src,
NSTRBYTE  size,
int  resize_flag 
)

Definition at line 1030 of file n_str.c.

◆ nstrdup()

N_STR * nstrdup ( N_STR str)

Duplicate a N_STR.

Parameters
strA N_STR *object to free
Returns
A valid N_STR or NULL

Definition at line 670 of file n_str.c.

References __n_assert, data, Free, length, LOG_ERR, n_log, new_nstr(), and written.

Referenced by add_nstrdup_to_msg(), n_vigenere_cypher(), netw_pool_broadcast(), and userlist_add_msg_to_ex().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ nstrprintf_cat_ex()

N_STR * nstrprintf_cat_ex ( N_STR **  nstr_var,
const char *  format,
  ... 
)

Definition at line 1488 of file n_str.c.

◆ nstrprintf_ex()

N_STR * nstrprintf_ex ( N_STR **  nstr_var,
const char *  format,
  ... 
)

Definition at line 1443 of file n_str.c.

◆ resize_nstr()

int resize_nstr ( N_STR nstr,
size_t  size 
)

reallocate a nstr internal buffer.

Warning: N_STR content will be reset !

Parameters
nstrtargeted N_STR *string
sizenew internal buffer size
Returns
TRUE or FALSE

Definition at line 1413 of file n_str.c.

References __n_assert, data, Free, length, Malloc, Reallocz, and written.

◆ scan_dir()

int scan_dir ( const char *  dir,
LIST result,
const int  recurse 
)

Scan a list of directory and return a list of char *file.

Parameters
dirThe directory to scan
resultA pointer to a valid LIST for the results
recurseRecursive search if TRUE, directory only if FALSE
Returns
TRUE or FALSE

Definition at line 1137 of file n_str.c.

References scan_dir_ex().

+ Here is the call graph for this function:

◆ scan_dir_ex()

int scan_dir_ex ( const char *  dir,
const char *  pattern,
LIST result,
const int  recurse,
const int  mode 
)

Scan a list of directory and return a list of char *file.

Parameters
dirThe directory to scan
patternPattern that files must follow to figure in the list
resultA pointer to a valid LIST for the results
recurseRecursive search if TRUE, directory only if FALSE
mode0 for a list of char* , 1 for a list of N_STR *
Returns
TRUE or FALSE

Definition at line 1150 of file n_str.c.

References data, free_nstr, free_nstr_ptr(), list_push(), LOG_ERR, n_log, nstrprintf, scan_dir_ex(), and wildmatcase().

Referenced by scan_dir(), and scan_dir_ex().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ skipu()

int skipu ( char *  string,
char  toskip,
NSTRBYTE iterator,
int  inc 
)

skip until 'toskip' occurence is found from 'iterator' to the next 'toskip' value.

The new iterator index is automatically stored, returning to it first value if an error append.

Parameters
stringa char *stri:wqng to search in
toskipskipping while char character 'toskip' isnt found
iteratoran int iteraor position on the string
incan int to specify the step of skipping
Returns
TRUE if success FALSE or ABORT if not

Definition at line 750 of file n_str.c.

References __n_assert.

Referenced by load_config_file().

+ Here is the caller graph for this function:

◆ skipw()

int skipw ( char *  string,
char  toskip,
NSTRBYTE iterator,
int  inc 
)

skip while 'toskip' occurence is found from 'iterator' to the next non 'toskip' position.

The new iterator index is automatically stored, returning to it first value if an error append.

Parameters
stringa char *string to search in
toskipskipping while char character 'toskip' is found
iteratoran int iteraor position on the string
incan int to specify the step of skipping
Returns
TRUE if success FALSE or ABORT if not

Definition at line 701 of file n_str.c.

References __n_assert.

◆ split()

char ** split ( const char *  str,
const char *  delim,
int  empty 
)

split the strings into a an array of char *pointer , ended by a NULL one.

Parameters
strThe char *str to split
delimThe delimiter, one or more characters
emptyEmpty flag. If 1, then empty delimited areas will be added as NULL entries, else they will be skipped.
Returns
An array of char *, ended by a NULL entry.

Definition at line 874 of file n_str.c.

References __n_assert, free_split_result(), and Malloc.

Referenced by n_kafka_delivery_message_callback(), n_kafka_load_config(), and strcpy_u().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ split_count()

int split_count ( char **  split_result)

Count split elements.

Parameters
split_resultA char **result from a split call
Returns
a joined string using delimiter with The number of elements or -1 if errors

Definition at line 954 of file n_str.c.

References __n_assert.

Referenced by load_config_file(), n_kafka_delivery_message_callback(), and n_kafka_load_config().

+ Here is the caller graph for this function:

◆ str_replace()

char * str_replace ( const char *  string,
const char *  substr,
const char *  replacement 
)

Replace "substr" by "replacement" inside string taken from http://coding.debuntu.org/c-implementing-str_replace-replace-all-occurrences-substring By Chantra.

Parameters
stringOriginal string to modify
substrString to search
replacementSubstitution string
Returns
A copy of the sustituted string or NULL

Definition at line 1341 of file n_str.c.

References Malloc.

Referenced by load_config_file().

+ Here is the caller graph for this function:

◆ str_sanitize()

int str_sanitize ( char *  string,
const char *  mask,
const char  replacement 
)

clean a string by replacing evil characteres

Parameters
stringThe string to change
maskThe caracters to kill
replacementreplacement for mask
Returns
TRUE or FALSE

Definition at line 1403 of file n_str.c.

References str_sanitize_ex().

+ Here is the call graph for this function:

◆ str_sanitize_ex()

int str_sanitize_ex ( char *  string,
const NSTRBYTE  string_len,
const char *  mask,
const NSTRBYTE  masklen,
const char  replacement 
)

clean a string by replacing evil characteres

Parameters
stringThe string to change
string_lenSize of the data to treat
maskThe caracters to kill
masklensize of mask
replacementreplacement for mask
Returns
TRUE or FALSE

Definition at line 1380 of file n_str.c.

References __n_assert.

Referenced by str_sanitize().

+ Here is the caller graph for this function:

◆ str_to_int()

int str_to_int ( const char *  s,
int *  i,
const int  base 
)

Helper for string to integer.

Parameters
sString to convert
iA pointer to an integer variable which will receieve the value.
baseBase for converting values
Returns
TRUE or FALSE

Definition at line 511 of file n_str.c.

References str_to_int_ex().

+ Here is the call graph for this function:

◆ str_to_int_ex()

int str_to_int_ex ( const char *  s,
NSTRBYTE  start,
NSTRBYTE  end,
int *  i,
const int  base 
)

Helper for string[start to end] to integer.

Automatically add /0 for conversion. Leave values untouched if any error occur. Work on a copy of the chunk.

Parameters
sString to convert
startStart position of the chunk
endEnd position of the chunk
iA pointer to an integer variable which will receive the value.
baseBase for converting values
Returns
TRUE or FALSE

Definition at line 424 of file n_str.c.

References __n_assert, Free, LOG_ERR, Malloc, and n_log.

Referenced by str_to_int().

+ Here is the caller graph for this function:

◆ str_to_int_nolog()

int str_to_int_nolog ( const char *  s,
NSTRBYTE  start,
NSTRBYTE  end,
int *  i,
const int  base,
N_STR **  infos 
)

Helper for string[start to end] to integer.

Automatically add /0 for conversion. Leave values untouched if any error occur. Work on a copy of the chunk.

Parameters
sString to convert
startStart position of the chunk
endEnd position of the chunk
iA pointer to an integer variable which will receieve the value.
baseBase for converting values
infosIf not NULL , contain the errors. remember to free the pointer if returned !!
Returns
TRUE or FALSE

Definition at line 470 of file n_str.c.

References __n_assert, Free, LOG_ERR, Malloc, n_log, and nstrprintf.

◆ str_to_long()

int str_to_long ( const char *  s,
long int *  i,
const int  base 
)

Helper for string to integer.

Parameters
sString to convert
iA pointer to an integer variable which will receieve the value.
baseBase for converting values
Returns
TRUE or FALSE

Definition at line 642 of file n_str.c.

References str_to_long_ex().

+ Here is the call graph for this function:

◆ str_to_long_ex()

int str_to_long_ex ( const char *  s,
NSTRBYTE  start,
NSTRBYTE  end,
long int *  i,
const int  base 
)

Helper for string[start to end] to long integer.

Automatically add /0 for conversion. Leave values untouched if any error occur. Work on a copy of the chunk.

Parameters
sString to convert
startStart position of the chunk
endEnd position of the chunk
iA pointer to an integer variable which will receieve the value.
baseBase for converting values
Returns
TRUE or FALSE

Definition at line 530 of file n_str.c.

References __n_assert, Free, LOG_DEBUG, LOG_ERR, Malloc, and n_log.

Referenced by str_to_long().

+ Here is the caller graph for this function:

◆ str_to_long_long()

int str_to_long_long ( const char *  s,
long long int *  i,
const int  base 
)

Helper for string to integer.

Parameters
sString to convert
iA pointer to an integer variable which will receieve the value.
baseBase for converting values
Returns
TRUE or FALSE

Definition at line 657 of file n_str.c.

References str_to_long_long_ex().

+ Here is the call graph for this function:

◆ str_to_long_long_ex()

int str_to_long_long_ex ( const char *  s,
NSTRBYTE  start,
NSTRBYTE  end,
long long int *  i,
const int  base 
)

Helper for string[start to end] to long long integer.

Automatically add /0 for conversion. Leave values untouched if any error occur. Work on a copy of the chunk.

Parameters
sString to convert
startStart position of the chunk
endEnd position of the chunk
iA pointer to an integer variable which will receieve the value.
baseBase for converting values
Returns
TRUE or FALSE

Definition at line 587 of file n_str.c.

References __n_assert, Free, LOG_DEBUG, LOG_ERR, Malloc, and n_log.

Referenced by str_to_long_long().

+ Here is the caller graph for this function:

◆ strcpy_u()

int strcpy_u ( char *  from,
char *  to,
NSTRBYTE  to_size,
char  split,
NSTRBYTE it 
)

Copy from start to dest until from[ iterator ] == split.

Parameters
fromSource string
toDest string
to_sizethe maximum size to write
splitstopping character
itSave of iterator
Returns
TRUE or FALSE

Definition at line 838 of file n_str.c.

References __n_assert, LOG_DEBUG, n_log, and split().

+ Here is the call graph for this function:

◆ strlo()

int strlo ( char *  string,
char *  dest 
)

Upper case a string.

Parameters
stringthe string to change to lower case
destthe string where storing result
Warning
string must be same size as dest
Returns
TRUE or FALSE

Definition at line 817 of file n_str.c.

References __n_assert.

◆ strup()

int strup ( char *  string,
char *  dest 
)

Upper case a string.

Parameters
stringthe string to change to upper case
destthe string where storing result
Warning
string must be same size as dest
Returns
TRUE or FALSE

Definition at line 798 of file n_str.c.

References __n_assert.

◆ trim()

char * trim ( char *  s)

trim and put a \0 at the end, return new char *

Parameters
sThe string to trim
Returns
the trimmed string or NULL

Definition at line 131 of file n_str.c.

References __n_assert, and trim_nocopy().

+ Here is the call graph for this function:

◆ trim_nocopy()

char * trim_nocopy ( char *  s)

trim and zero end the string, WARNING: keep and original pointer to delete the string correctly

Parameters
sThe string to trim
Returns
the trimmed string or NULL

Definition at line 102 of file n_str.c.

References __n_assert.

Referenced by load_config_file(), and trim().

+ Here is the caller graph for this function:

◆ wildmat()

int wildmat ( register const char *  text,
register const char *  p 
)

Written by Rich Salz rsalz at osf.org, refurbished by me.

Wildcard pattern matching .

Parameters
textThe source text to search
pThe text to search, with wildcards
Returns
return TRUE, FALSE, or WILDMAT_ABORT.

Definition at line 1211 of file n_str.c.

References wildmat(), WILDMAT_ABORT, and WILDMAT_NEGATE_CLASS.

Referenced by wildmat().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ wildmatcase()

int wildmatcase ( register const char *  text,
register const char *  p 
)

Written by Rich Salz rsalz at osf.org, refurbished by me.

Wildcard pattern matching case insensitive.

Parameters
textThe source text to search
pThe text to search, with wildcards
Returns
return TRUE, FALSE, or WILDMAT_ABORT.

Definition at line 1275 of file n_str.c.

References WILDMAT_ABORT, WILDMAT_NEGATE_CLASS, and wildmatcase().

Referenced by scan_dir_ex(), and wildmatcase().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ write_and_fit()

int write_and_fit ( char **  dest,
NSTRBYTE size,
NSTRBYTE written,
const char *  src 
)

concatenate a copy of src of size strlen( src ) to dest, starting at dest[ written ], updating written and size variable, allocation of new blocks of (needed size + 512) if resize is needed.

If dest is NULL it will be allocated.

Parameters
destThe dest string
sizeThe current size, will be updated if written + strlen( dest) > size
writtenthe number of octet added
srcThe source string to add
Returns
TRUE on success or FALSE on a realloc error

Definition at line 1126 of file n_str.c.

References write_and_fit_ex().

+ Here is the call graph for this function:

◆ write_and_fit_ex()

int write_and_fit_ex ( char **  dest,
NSTRBYTE size,
NSTRBYTE written,
const char *  src,
NSTRBYTE  src_size,
NSTRBYTE  additional_padding 
)

concatenate a copy of src of size src_size to dest, starting at dest[ written ], updating written and size variable, allocation of new blocks of (needed size + additional_padding ) if resize is needed.

If dest is NULL it will be allocated.

Parameters
destThe dest string
sizeThe current size, will be updated if written + strlen( dest) > size
writtenthe number of octet added
srcThe source string to add
src_sizeThe source string size
additional_paddingIn case the destination is reallocated, number of additional bytes that will be added (provisionning)
Returns
TRUE on success or FALSE on a realloc error

Definition at line 1093 of file n_str.c.

References LOG_ERR, n_log, and Reallocz.

Referenced by write_and_fit().

+ Here is the caller graph for this function: