DynamicStrings

Functions
TRIO_STRING_PRIVATE trio_string_t *	TrioStringAlloc (TRIO_NOARGS)
TRIO_STRING_PRIVATE BOOLEAN_T TrioStringGrow	TRIO_ARGS2 ((self, delta), trio_string_t *self, size_t delta)
TRIO_STRING_PRIVATE BOOLEAN_T TrioStringGrowTo	TRIO_ARGS2 ((self, length), trio_string_t *self, size_t length)
TRIO_STRING_PUBLIC trio_string_t *trio_string_create	TRIO_ARGS1 ((initial_size), int initial_size)
TRIO_STRING_PUBLIC void trio_string_destroy	TRIO_ARGS1 ((self), trio_string_t *self)
TRIO_STRING_PUBLIC char *trio_string_get	TRIO_ARGS2 ((self, offset), trio_string_t *self, int offset)
TRIO_STRING_PUBLIC void trio_xstring_set	TRIO_ARGS2 ((self, buffer), trio_string_t *self, char *buffer)
TRIO_STRING_PUBLIC int trio_string_append	TRIO_ARGS2 ((self, other), trio_string_t *self, trio_string_t *other)
TRIO_STRING_PUBLIC int trio_xstring_append	TRIO_ARGS2 ((self, other), trio_string_t *self, TRIO_CONST char *other)
TRIO_STRING_PUBLIC int trio_xstring_append_char	TRIO_ARGS2 ((self, character), trio_string_t *self, char character)
TRIO_STRING_PUBLIC trio_string_t *trio_string_duplicate	TRIO_ARGS1 ((other), trio_string_t *other)
TRIO_STRING_PUBLIC trio_string_t *trio_xstring_duplicate	TRIO_ARGS1 ((other), TRIO_CONST char *other)
TRIO_STRING_PUBLIC int trio_string_equal_max	TRIO_ARGS3 ((self, max, other), trio_string_t *self, size_t max, trio_string_t *other)
TRIO_STRING_PUBLIC int trio_xstring_equal_max	TRIO_ARGS3 ((self, max, other), trio_string_t *self, size_t max, TRIO_CONST char *other)
TRIO_STRING_PUBLIC size_t trio_string_format_date_max	TRIO_ARGS4 ((self, max, format, datetime), trio_string_t *self, size_t max, TRIO_CONST char *format, TRIO_CONST struct tm *datetime)
TRIO_STRING_PUBLIC char *trio_string_index	TRIO_ARGS2 ((self, character), trio_string_t *self, int character)

Detailed Description

Function Documentation

TRIO_ARGS1() [1/4]

TRIO_STRING_PUBLIC trio_string_t *trio_string_create TRIO_ARGS1	(	(initial_size)	,
		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.

Definition at line 1349 of file triostr.c.

{
  trio_string_t *self;
 
  self = TrioStringAlloc();
  if (self)
    {
      if (TrioStringGrow(self,
             (size_t)((initial_size > 0) ? initial_size : 1)))
    {
      self->content[0] = (char)0;
      self->allocated = initial_size;
    }
      else
    {
      trio_string_destroy(self);
      self = NULL;
    }
    }
  return self;
}

TRIO_ARGS1() [2/4]

TRIO_STRING_PUBLIC trio_string_t *trio_xstring_duplicate TRIO_ARGS1	(	(other)	,
		TRIO_CONST char *	other
	)

Definition at line 1727 of file triostr.c.

{
  trio_string_t *self;
 
  assert(other);
 
  self = TrioStringAlloc();
  if (self)
    {
      self->content = TrioDuplicateMax(other, trio_length(other));
      if (self->content)
    {
      self->length = trio_length(self->content);
      self->allocated = self->length + 1;
    }
      else
    {
      self->length = self->allocated = 0;
    }
    }
  return self;
}

TRIO_ARGS1() [3/4]

TRIO_STRING_PUBLIC trio_string_t *trio_string_duplicate TRIO_ARGS1	(	(other)	,
		trio_string_t *	other
	)

Definition at line 1696 of file triostr.c.

{
  trio_string_t *self;
 
  assert(other);
 
  self = TrioStringAlloc();
  if (self)
    {
      self->content = TrioDuplicateMax(other->content, other->length);
      if (self->content)
    {
      self->length = other->length;
      self->allocated = self->length + 1;
    }
      else
    {
      self->length = self->allocated = 0;
    }
    }
  return self;
}

TRIO_ARGS1() [4/4]

TRIO_STRING_PUBLIC int trio_string_upper TRIO_ARGS1	(	(self)	,
		trio_string_t *	self
	)

Deallocate the dynamic string and its contents.

Parameters

self	Dynamic string

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.

Definition at line 1381 of file triostr.c.

{
  assert(self);
 
  if (self)
    {
      trio_destroy(self->content);
      TRIO_FREE(self);
    }
}

TRIO_ARGS2() [1/8]

TRIO_STRING_PUBLIC void trio_xstring_set TRIO_ARGS2	(	(self, buffer)	,
		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.

Definition at line 1489 of file triostr.c.

{
  assert(self);
 
  trio_destroy(self->content);
  self->content = trio_duplicate(buffer);
}

TRIO_ARGS2() [2/8]

TRIO_STRING_PUBLIC int trio_xstring_append_char TRIO_ARGS2	(	(self, character)	,
		trio_string_t *	self,
		char	character
	)

Definition at line 1592 of file triostr.c.

{
  assert(self);
 
  if ((int)self->length >= trio_string_size(self))
    {
      if (!TrioStringGrow(self, 0))
    goto error;
    }
  self->content[self->length] = character;
  self->length++;
  return TRUE;
 
 error:
  return FALSE;
}

TRIO_ARGS2() [3/8]

TRIO_STRING_PUBLIC char *trio_string_index_last TRIO_ARGS2	(	(self, character)	,
		trio_string_t *	self,
		int	character
	)

Definition at line 1925 of file triostr.c.

{
  assert(self);
 
  return trio_index(self->content, character);
}

TRIO_ARGS2() [4/8]

TRIO_STRING_PRIVATE BOOLEAN_T TrioStringGrow TRIO_ARGS2	(	(self, delta)	,
		trio_string_t *	self,
		size_t	delta
	)

Definition at line 1295 of file triostr.c.

{
  BOOLEAN_T status = FALSE;
  char *new_content;
  size_t new_size;
 
  new_size = (delta == 0)
    ? ( (self->allocated == 0) ? 1 : self->allocated * 2 )
    : self->allocated + delta;
 
  new_content = (char *)TRIO_REALLOC(self->content, new_size);
  if (new_content)
    {
      self->content = new_content;
      self->allocated = new_size;
      status = TRUE;
    }
  return status;
}

TRIO_ARGS2() [5/8]

TRIO_STRING_PRIVATE BOOLEAN_T TrioStringGrowTo TRIO_ARGS2	(	(self, length)	,
		trio_string_t *	self,
		size_t	length
	)

Definition at line 1328 of file triostr.c.

{
  length++; /* Room for terminating zero */
  return (self->allocated < length)
    ? TrioStringGrow(self, length - self->allocated)
    : TRUE;
}

TRIO_ARGS2() [6/8]

TRIO_STRING_PUBLIC char *trio_string_get TRIO_ARGS2	(	(self, offset)	,
		trio_string_t *	self,
		int	offset
	)

Get a pointer to the content.

Parameters

self	Dynamic string.
offset	Offset into content.

Returns

Pointer to the content.

Offset can be zero, positive, or negative. If offset is zero, then the start of the content will be returned. If offset is positive, then a pointer to offset number of characters from the beginning of the content is returned. If offset is negative, then a pointer to offset number of characters from the ending of the string, starting at the terminating zero, is returned.

Definition at line 1411 of file triostr.c.

{
  char *result = NULL;
 
  assert(self);
 
  if (self->content != NULL)
    {
      if (self->length == 0)
    {
      (void)trio_string_length(self);
    }
      if (offset >= 0)
    {
      if (offset > (int)self->length)
        {
          offset = self->length;
        }
    }
      else
    {
      offset += self->length + 1;
      if (offset < 0)
        {
          offset = 0;
        }
    }
      result = &(self->content[offset]);
    }
  return result;
}

TRIO_ARGS2() [7/8]

TRIO_STRING_PUBLIC char *trio_xstring_substring TRIO_ARGS2	(	(self, other)	,
		trio_string_t *	self,
		TRIO_CONST char *	other
	)

Definition at line 1565 of file triostr.c.

{
  size_t length;
 
  assert(self);
  assert(other);
 
  length = self->length + trio_length(other);
  if (!TrioStringGrowTo(self, length))
    goto error;
  trio_copy(&self->content[self->length], other);
  self->length = length;
  return TRUE;
 
 error:
  return FALSE;
}

TRIO_ARGS2() [8/8]

TRIO_STRING_PUBLIC char *trio_string_substring TRIO_ARGS2	(	(self, other)	,
		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.

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.

Definition at line 1537 of file triostr.c.

{
  size_t length;
 
  assert(self);
  assert(other);
 
  length = self->length + other->length;
  if (!TrioStringGrowTo(self, length))
    goto error;
  trio_copy(&self->content[self->length], other->content);
  self->length = length;
  return TRUE;
 
 error:
  return FALSE;
}

TRIO_ARGS3() [1/2]

TRIO_STRING_PUBLIC int trio_xstring_equal_case_max TRIO_ARGS3	(	(self, max, other)	,
		trio_string_t *	self,
		size_t	max,
		TRIO_CONST char *	other
	)

Definition at line 1813 of file triostr.c.

{
  assert(self);
  assert(other);
 
  return trio_equal_max(self->content, max, other);
}

TRIO_ARGS3() [2/2]

TRIO_STRING_PUBLIC int trio_string_equal_case_max TRIO_ARGS3	(	(self, max, other)	,
		trio_string_t *	self,
		size_t	max,
		trio_string_t *	other
	)

Definition at line 1794 of file triostr.c.

{
  assert(self);
  assert(other);
 
  return trio_equal_max(self->content, max, other->content);
}

TRIO_ARGS4()

TRIO_STRING_PUBLIC size_t trio_string_format_date_max TRIO_ARGS4	(	(self, max, format, datetime)	,
		trio_string_t *	self,
		size_t	max,
		TRIO_CONST char *	format,
		TRIO_CONST struct tm *	datetime
	)

Definition at line 1906 of file triostr.c.

{
  assert(self);
 
  return trio_format_date_max(self->content, max, format, datetime);
}

TrioStringAlloc()

TRIO_STRING_PRIVATE trio_string_t * TrioStringAlloc

(

TRIO_NOARGS

)

Definition at line 1272 of file triostr.c.

{
  trio_string_t *self;
 
  self = (trio_string_t *)TRIO_MALLOC(sizeof(trio_string_t));
  if (self)
    {
      self->content = NULL;
      self->length = 0;
      self->allocated = 0;
    }
  return self;
}

Referenced by TRIO_ARGS1().