n_str.h File Reference

N_STR and string function declaration. More...

#include "n_common.h"
#include "n_list.h"
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <strings.h>
#include <math.h>
#include <fcntl.h>
#include <unistd.h>
#include <inttypes.h>

Include dependency graph for n_str.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

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

Macros
#define	BAD_METACHARS   "/-+&;`'\\\"|*?~<>^()[]{}$\n\r\t "
	list of evil characters
#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_STR *	char_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_STR *	char_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_STR *	file_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_STR *	new_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_STR *	nstrcat_bytes_ex (N_STR **dest, void *src, NSTRBYTE size)
	Append data into N_STR using internal N_STR size and cursor position.
N_STR *	nstrcat_ex (N_STR **dest, void *src, NSTRBYTE size, int resize_flag)
	Append data into N_STR using internal N_STR size and cursor position.
N_STR *	nstrdup (N_STR *msg)
	Duplicate a N_STR.
N_STR *	nstrprintf_cat_ex (N_STR **nstr_var, const char *format,...)
	Function to allocate, format, and concatenate a string into an N_STR object.
N_STR *	nstrprintf_ex (N_STR **nstr_var, const char *format,...)
	Function to allocate and format a string into an N_STR object.
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

N_STR and string function declaration.

Author

Castagnier Mickael

Version

2.0

Date

05/02/14

Definition in file n_str.h.

Macro Definition Documentation

BAD_METACHARS

#define BAD_METACHARS   "/-+&;`'\\\"|*?~<>^()[]{}$\n\r\t "

list of evil characters

Definition at line 12 of file n_str.h.