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