DynamicStrings

Funciones
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)

---

Documentación de las funciones

TRIO_STRING_PUBLIC trio_string_t* trio_string_create TRIO_ARGS1	(	(initial_size)	,
		int	initial_size
	)

Create a new dynamic string.

Parámetros:

initial_size

Initial size of the buffer.

Devuelve:

Newly allocated dynamic string, or NULL if memory allocation failed.

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

Deallocate the dynamic string and its contents.

Parámetros:

self	Dynamic string

Extract the content.

Parámetros:

self	Dynamic String

Devuelve:

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

Append the second string to the first.

Parámetros:

self	Dynamic string to be modified.
other	Dynamic string to copy from.

Devuelve:

Boolean value indicating success or failure.

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

Parámetros:

self	Dynamic string to be modified.
other	Dynamic string to copy from.

Devuelve:

Boolean value indicating success or failure.

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

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

TRIO_STRING_PUBLIC char *trio_xstring_substring 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_PRIVATE BOOLEAN_T TrioStringGrowTo TRIO_ARGS2	(	(self, length)	,
		trio_string_t *	self,
		size_t	length
	)

TRIO_STRING_PUBLIC void trio_xstring_set TRIO_ARGS2	(	(self, buffer)	,
		trio_string_t *	self,
		char *	buffer
	)

Set the content of the dynamic string.

Parámetros:

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.

Comentarios:

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

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

Get a pointer to the content.

Parámetros:

self	Dynamic string.
offset	Offset into content.

Devuelve:

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.

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
	)

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
	)

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_PRIVATE trio_string_t* TrioStringAlloc

(

TRIO_NOARGS

)