Main Page   Modules   Compound List   File List   Compound Members   File Members   Related Pages  

Dynamic string functions
[LibTDS API]

Handle dynamic string. More...

Defines

#define tds_dstr_init(s)   do { *(s) = (DSTR) &tds_str_empty[0]; } while(0)
 init a string with empty

#define tds_dstr_isempty(s)   ((*(s))->dstr_s[0] == '\0')
 test if string is empty

#define tds_dstr_cstr(s)   ((*(s))->dstr_s)
#define tds_dstr_len(s)   strlen((*(s))->dstr_s)

Functions

void tds_dstr_zero (DSTR *s)
 clear all string filling with zeroes (mainly for security reason)

void tds_dstr_free (DSTR *s)
 free string

DSTR tds_dstr_copyn (DSTR *s, const char *src, unsigned int length)
 Set string to a given buffer of characters.

DSTR tds_dstr_set (DSTR *s, char *src)
 set a string from another buffer.

DSTR tds_dstr_copy (DSTR *s, const char *src)
 copy a string from another


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_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,
unsigned int  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


Generated on Tue Mar 29 19:52:37 2005 for FreeTDS API by doxygen1.3