dstring.h File Reference

#include "types/dstring.h"

Include dependency graph for dstring.h:

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

Go to the source code of this file.

Functions
void	dstring_init (dstring_t *string, unsigned int buffer_size)
	Initializes a dynamic string (dstring).
void	dstring_close (dstring_t *string)
	Closes the dynamic string.
void	dstring_putchar (dstring_t *string, int character)
	Concatenates a character on the end of the dstring.
void	dstring_concat (dstring_t *string, const char *source)
	Concatenates a string on the end of the dstring.
void	dstring_copy (dstring_t *string, const char *source)
	Copies the content of source to the dstring.

Function Documentation

dstring_close()

void dstring_close

(

dstring_t *

string

)

Closes the dynamic string.

Parameters

string

The string to be closed.

Definition at line 18 of file dstring.c.

{
  if (! string->data) {
    return;
  }
 
  free(string->data);
  string->data = NULL;
}

dstring_concat()

void dstring_concat	(	dstring_t *	string,
		const char *	source )

Concatenates a string on the end of the dstring.

Parameters

string	The dstring where to concatenate the string.
source	The string to be concatenated.

Definition at line 38 of file dstring.c.

{
  size_t source_length = strlen(source);
 
  _dstring_ensure_size(string, string->length + source_length + 1);
 
  memcpy(string->data + string->length, source, source_length + 1);
 
  string->length += source_length;
}

dstring_copy()

void dstring_copy	(	dstring_t *	string,
		const char *	source )

Copies the content of source to the dstring.

Parameters

string	The dstring where to copy.
source	The string to be copied.

Definition at line 50 of file dstring.c.

{
  size_t source_length = strlen(source);
 
  _dstring_ensure_size(string, source_length + 1);
 
  memcpy(string->data, source, source_length + 1);
 
  string->length = source_length;
}

dstring_init()

void dstring_init	(	dstring_t *	string,
		unsigned int	buffer_size )

Initializes a dynamic string (dstring).

The dynamic string automatically realloc her buffer when needed. So you don't need to care about buffer sizes.

Parameters

string	Pointer for the dstring to be initialized.
buffer_size	The initial buffer size for the string. If zero, doesn't allocate memory until required.

Definition at line 10 of file dstring.c.

{
  string->length = 0;
  string->_buffer_size = buffer_size;
  string->data = (buffer_size == 0) ? NULL : malloc(buffer_size);
}

dstring_putchar()

void dstring_putchar	(	dstring_t *	string,
		int	character )

Concatenates a character on the end of the dstring.

Parameters

string	The dstring where to concatenate the character.
character	The character to be concatenated.

Definition at line 29 of file dstring.c.

{
  _dstring_ensure_size(string, string->length + 2);
 
  string->data[string->length++] = character;
  string->data[string->length] = '\0';
}