Dynamic string functions
[LibTDS API]

Handle dynamic string. More...

Defines
#define	tds_dstr_buf(s)   ((s)->dstr_s)
#define	tds_dstr_cstr(s)   ((const char* ) tds_dstr_buf(s))
#define	tds_dstr_init(s)   do { DSTR *_tds_s = (s); _tds_s->dstr_size = 0; _tds_s->dstr_s = (char*) tds_str_empty; } while(0)
	init a string with empty
#define	tds_dstr_isempty(s)   ((s)->dstr_size == 0)
	test if string is empty
#define	tds_dstr_len(s)   ((s)->dstr_size)
Functions
DSTR *	tds_dstr_alloc (DSTR *s, size_t length)
	allocate space for length char
DSTR *	tds_dstr_copy (DSTR *s, const char *src)
	copy a string from another
DSTR *	tds_dstr_copyn (DSTR *s, const char *src, size_t length)
	Set string to a given buffer of characters.
DSTR *	tds_dstr_dup (DSTR *s, const DSTR *src)
void	tds_dstr_free (DSTR *s)
	free string
DSTR *	tds_dstr_set (DSTR *s, char *src)
	set a string from another buffer.
DSTR *	tds_dstr_setlen (DSTR *s, size_t length)
	limit length of string, MUST be <= current length
void	tds_dstr_zero (DSTR *s)
	clear all string filling with zeroes (mainly for security reason)

---

Detailed Description

Handle dynamic string.

In this string are always valid (you don't have NULL pointer, only empty string)

---

Function Documentation

DSTR * tds_dstr_alloc	(	DSTR *	s,
		size_t	length
	)

allocate space for length char

Parameters:

	s	dynamic string
	length	new length

Returns:

string allocated or NULL on memory error

DSTR * tds_dstr_copy	(	DSTR *	s,
		const char *	src
	)

copy a string from another

Parameters:

	s	dynamic string
	src	source buffer

Returns:

string copied or NULL on memory error

DSTR * tds_dstr_copyn	(	DSTR *	s,
		const char *	src,
		size_t	length
	)

Set string to a given buffer of characters.

Parameters:

	s	dynamic string
	src	source buffer
	length	length of source buffer

Returns:

string copied or NULL on memory error

DSTR * tds_dstr_set	(	DSTR *	s,
		char *	src
	)

set a string from another buffer.

The string will use the supplied buffer (it not copy the string), so it should be a pointer returned by malloc.

Parameters:

	s	dynamic string
	src	source buffer

Returns:

string copied or NULL on memory error

DSTR * tds_dstr_setlen	(	DSTR *	s,
		size_t	length
	)

limit length of string, MUST be <= current length

Parameters:

	s	dynamic string
	length	new length