Main Page   Modules  

Dynamic String Functions.

Dynamic string functions. More...

Functions

TRIO_PUBLIC_STRING trio_string_t * trio_string_create (int initial_size)
 Create a new dynamic string.

TRIO_PUBLIC_STRING void trio_string_destroy (trio_string_t *self)
 Deallocate the dynamic string and its contents.

TRIO_PUBLIC_STRING char * trio_string_extract (trio_string_t *self)
 Extract the content.

TRIO_PUBLIC_STRING void trio_xstring_set (trio_string_t *self, char *buffer)
 Set the content of the dynamic string.

TRIO_PUBLIC_STRING int trio_string_append (trio_string_t *self, trio_string_t *other)
 Append the second string to the first.

TRIO_PUBLIC_STRING int trio_string_contains (trio_string_t *self, trio_string_t *other)
 Search for the first occurrence of second parameter in the first.


Detailed Description

Dynamic string functions.

SYNOPSIS

cc ... -ltrio -lm

#include <triostr.h>

DESCRIPTION


Function Documentation

TRIO_PUBLIC_STRING int trio_string_append trio_string_t *    self,
trio_string_t *    other
 

Append the second string to the first.

Parameters:
self  Dynamic string to be modified.
other  Dynamic string to copy from.
Returns:
Boolean value indicating success or failure.

TRIO_PUBLIC_STRING int trio_string_contains trio_string_t *    self,
trio_string_t *    other
 

Search for the first occurrence of second parameter in the first.

Parameters:
self  Dynamic string to be modified.
other  Dynamic string to copy from.
Returns:
Boolean value indicating success or failure.

TRIO_PUBLIC_STRING trio_string_t* trio_string_create int    initial_size
 

Create a new dynamic string.

Parameters:
initial_size  Initial size of the buffer.
Returns:
Newly allocated dynamic string, or NULL if memory allocation failed.

TRIO_PUBLIC_STRING void trio_string_destroy trio_string_t *    self
 

Deallocate the dynamic string and its contents.

Parameters:
self  Dynamic string

TRIO_PUBLIC_STRING char* trio_string_extract trio_string_t *    self
 

Extract the content.

Parameters:
self  Dynamic String
Returns:
Content of dynamic string.
The content is removed from the dynamic string. This enables destruction of the dynamic string without deallocation of the content.

TRIO_PUBLIC_STRING void trio_xstring_set trio_string_t *    self,
char *    buffer
 

Set the content of the dynamic string.

Parameters:
self  Dynamic String
buffer  The new content.
Sets the content of the dynamic string to a copy buffer. An existing content will be deallocated first, if necessary.

Remarks:
This function will make a copy of buffer. You are responsible for deallocating buffer yourself.