StaticStrings

Funciones
TRIO_STRING_PUBLIC char *trio_create	TRIO_ARGS1 ((size), size_t size)
TRIO_STRING_PUBLIC void trio_destroy	TRIO_ARGS1 ((string), char *string)
TRIO_STRING_PUBLIC size_t trio_length	TRIO_ARGS1 ((string), TRIO_CONST char *string)
TRIO_STRING_PUBLIC int trio_append	TRIO_ARGS2 ((target, source), char *target, TRIO_CONST char *source)
TRIO_STRING_PUBLIC int trio_append_max	TRIO_ARGS3 ((target, max, source), char *target, size_t max, TRIO_CONST char *source)
TRIO_STRING_PUBLIC int trio_contains	TRIO_ARGS2 ((string, substring), TRIO_CONST char *string, TRIO_CONST char *substring)
TRIO_STRING_PRIVATE char *TrioDuplicateMax	TRIO_ARGS2 ((source, size), TRIO_CONST char *source, size_t size)
TRIO_STRING_PUBLIC char *trio_duplicate	TRIO_ARGS1 ((source), TRIO_CONST char *source)
TRIO_STRING_PUBLIC char *trio_duplicate_max	TRIO_ARGS2 ((source, max), TRIO_CONST char *source, size_t max)
TRIO_STRING_PUBLIC int trio_equal	TRIO_ARGS2 ((first, second), TRIO_CONST char *first, TRIO_CONST char *second)
TRIO_STRING_PUBLIC int trio_equal_case_max	TRIO_ARGS3 ((first, max, second), TRIO_CONST char *first, size_t max, TRIO_CONST char *second)
TRIO_STRING_PUBLIC TRIO_CONST char *trio_error	TRIO_ARGS1 ((error_number), int error_number)
TRIO_STRING_PUBLIC size_t trio_format_date_max	TRIO_ARGS4 ((target, max, format, datetime), char *target, size_t max, TRIO_CONST char *format, TRIO_CONST struct tm *datetime)
TRIO_STRING_PUBLIC unsigned long trio_hash	TRIO_ARGS2 ((string, type), TRIO_CONST char *string, int type)
TRIO_STRING_PUBLIC char *trio_index	TRIO_ARGS2 ((string, character), TRIO_CONST char *string, int character)
TRIO_STRING_PUBLIC int trio_lower	TRIO_ARGS1 ((target), char *target)
TRIO_STRING_PUBLIC int trio_match	TRIO_ARGS2 ((string, pattern), TRIO_CONST char *string, TRIO_CONST char *pattern)
TRIO_STRING_PUBLIC size_t trio_span_function	TRIO_ARGS3 ((target, source, Function), char *target, TRIO_CONST char *source, int(*Function) TRIO_PROTO((int)))
TRIO_STRING_PUBLIC char *trio_substring_max	TRIO_ARGS3 ((string, max, substring), TRIO_CONST char *string, size_t max, TRIO_CONST char *substring)
TRIO_STRING_PUBLIC char *trio_tokenize	TRIO_ARGS2 ((string, delimiters), char *string, TRIO_CONST char *delimiters)
TRIO_STRING_PUBLIC trio_long_double_t trio_to_long_double	TRIO_ARGS2 ((source, endp), TRIO_CONST char *source, char **endp)
TRIO_STRING_PUBLIC long trio_to_long	TRIO_ARGS3 ((string, endp, base), TRIO_CONST char *string, char **endp, int base)
TRIO_STRING_PUBLIC int trio_to_lower	TRIO_ARGS1 ((source), int source)

---

Documentación de las funciones

TRIO_STRING_PUBLIC char* trio_create TRIO_ARGS1	(	(size)	,
		size_t	size
	)

Create new string.

Parámetros:

size	Size of new string.

Devuelve:

Pointer to string, or NULL if allocation failed.

TRIO_STRING_PUBLIC void trio_destroy TRIO_ARGS1	(	(string)	,
		char *	string
	)

Destroy string.

Parámetros:

string

String to be freed.

TRIO_STRING_PUBLIC char* trio_duplicate TRIO_ARGS1	(	(source)	,
		TRIO_CONST char *	source
	)

Duplicate source.

Parámetros:

source

Source string.

Devuelve:

A copy of the source string.

Postcondición:

target will be zero terminated.

TRIO_STRING_PUBLIC int trio_upper TRIO_ARGS1	(	(target)	,
		char *	target
	)

Convert the alphabetic letters in the string to lower-case.

Parámetros:

target

String to be converted.

Devuelve:

Number of processed characters (converted or not).

Convert the alphabetic letters in the string to upper-case.

Parámetros:

target

The string to be converted.

Devuelve:

The number of processed characters (converted or not).

TRIO_STRING_PUBLIC int trio_to_upper TRIO_ARGS1	(	(source)	,
		int	source
	)

Convert one alphabetic letter to lower-case.

Parámetros:

source

The letter to be converted.

Devuelve:

The converted letter.

Convert one alphabetic letter to upper-case.

Parámetros:

source

The letter to be converted.

Devuelve:

The converted letter.

TRIO_STRING_PUBLIC size_t trio_length TRIO_ARGS1	(	(string)	,
		TRIO_CONST char *	string
	)

Count the number of characters in a string.

Parámetros:

string

String to measure.

Devuelve:

Number of characters in .

TRIO_STRING_PUBLIC TRIO_CONST char* trio_error TRIO_ARGS1	(	(error_number)	,
		int	error_number
	)

Provide a textual description of an error code (errno).

Parámetros:

error_number

Error number.

Devuelve:

Textual description of error_number.

TRIO_STRING_PUBLIC int trio_copy TRIO_ARGS2	(	(target, source)	,
		char *	target,
		TRIO_CONST char *	source
	)

Append source at the end of target.

Parámetros:

target	Target string.
source	Source string.

Devuelve:

Boolean value indicating success or failure.

Precondición:

target must point to a memory chunk with sufficient room to contain the target string and source string.

No boundary checking is performed, so insufficient memory will result in a buffer overrun.

Postcondición:

target will be zero terminated.

Copy source to target.

Parámetros:

target	Target string.
source	Source string.

Devuelve:

Boolean value indicating success or failure.

Precondición:

target must point to a memory chunk with sufficient room to contain the source string.

No boundary checking is performed, so insufficient memory will result in a buffer overrun.

Postcondición:

target will be zero terminated.

TRIO_STRING_PUBLIC int trio_match_case TRIO_ARGS2	(	(string, pattern)	,
		TRIO_CONST char *	string,
		TRIO_CONST char *	pattern
	)

Compare two strings using wildcards.

Parámetros:

string	String to be searched.
pattern	Pattern, including wildcards, to search for.

Devuelve:

Boolean value indicating success or failure.

Case-insensitive comparison.

The following wildcards can be used

• * Match any number of characters.
• ? Match a single character.

Compare two strings using wildcards.

Parámetros:

string	String to be searched.
pattern	Pattern, including wildcards, to search for.

Devuelve:

Boolean value indicating success or failure.

Case-sensitive comparison.

The following wildcards can be used

• * Match any number of characters.
• ? Match a single character.

TRIO_STRING_PUBLIC char *trio_index_last TRIO_ARGS2	(	(string, character)	,
		TRIO_CONST char *	string,
		int	character
	)

Find first occurrence of a character in a string.

Parámetros:

string	String to be searched.
character	Character to be found.
A	pointer to the found character, or NULL if character was not found.

Find last occurrence of a character in a string.

Parámetros:

string	String to be searched.
character	Character to be found.
A	pointer to the found character, or NULL if character was not found.

TRIO_STRING_PUBLIC unsigned long trio_hash TRIO_ARGS2	(	(string, type)	,
		TRIO_CONST char *	string,
		int	type
	)

Calculate a hash value for a string.

Parámetros:

string	String to be calculated on.
type	Hash function.

Devuelve:

Calculated hash value.

type can be one of the following

• TRIO_HASH_PLAIN Plain hash function.

TRIO_STRING_PUBLIC char* trio_duplicate_max TRIO_ARGS2	(	(source, max)	,
		TRIO_CONST char *	source,
		size_t	max
	)

Duplicate at most max characters of source.

Parámetros:

source	Source string.
max	Maximum number of characters to duplicate.

Devuelve:

A copy of the source string.

Postcondición:

target will be zero terminated.

TRIO_STRING_PUBLIC float trio_to_float TRIO_ARGS2	(	(source, endp)	,
		TRIO_CONST char *	source,
		char **	endp
	)

Convert string to floating-point number.

Parámetros:

source	String to be converted.
endp	Pointer to end of the converted string.

Devuelve:

A floating-point number.

The following Extended Backus-Naur form is used

   double        ::= [ <sign> ]
                     ( <number> |
                       <number> <decimal_point> <number> |
                       <decimal_point> <number> )
                     [ <exponential> [ <sign> ] <number> ]
   number        ::= 1*( <digit> )
   digit         ::= ( '0' | '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9' )
   exponential   ::= ( 'e' | 'E' )
   sign          ::= ( '-' | '+' )
   decimal_point ::= '.'
   

Convert string to floating-point number.

Parámetros:

source	String to be converted.
endp	Pointer to end of the converted string.

Devuelve:

A floating-point number.

See trio_to_long_double.

TRIO_STRING_PUBLIC char* trio_tokenize TRIO_ARGS2	(	(string, delimiters)	,
		char *	string,
		TRIO_CONST char *	delimiters
	)

Tokenize string.

Parámetros:

string	String to be tokenized.
tokens	String containing list of delimiting characters.

Devuelve:

Start of new token.

Atención:

string will be destroyed.

TRIO_STRING_PUBLIC int trio_equal_locale TRIO_ARGS2	(	(first, second)	,
		TRIO_CONST char *	first,
		TRIO_CONST char *	second
	)

Compare if two strings are equal.

Parámetros:

first	First string.
second	Second string.

Devuelve:

Boolean indicating whether the two strings are equal or not.

Case-insensitive comparison.

Compare if two strings are equal.

Parámetros:

first	First string.
second	Second string.

Devuelve:

Boolean indicating whether the two strings are equal or not.

Case-sensitive comparison.

Compare if two strings are equal.

Parámetros:

first	First string.
second	Second string.

Devuelve:

Boolean indicating whether the two strings are equal or not.

Collating characters are considered equal.

TRIO_STRING_PUBLIC char *trio_substring TRIO_ARGS2	(	(string, substring)	,
		TRIO_CONST char *	string,
		TRIO_CONST char *	substring
	)

Determine if a string contains a substring.

Parámetros:

string	String to be searched.
substring	String to be found.

Devuelve:

Boolean value indicating success or failure.

Search for a substring in a string.

Parámetros:

string	String to be searched.
substring	String to be found.

Devuelve:

Pointer to first occurrence of substring in string, or NULL if no match was found.

TRIO_STRING_PRIVATE char* TrioDuplicateMax TRIO_ARGS2	(	(source, size)	,
		TRIO_CONST char *	source,
		size_t	size
	)

TRIO_STRING_PUBLIC unsigned long trio_to_unsigned_long TRIO_ARGS3	(	(string, endp, base)	,
		TRIO_CONST char *	string,
		char **	endp,
		int	base
	)

Convert string to signed integer.

Parámetros:

string	String to be converted.
endp	Pointer to end of converted string.
base	Radix number of number.

Convert string to unsigned integer.

Parámetros:

string	String to be converted.
endp	Pointer to end of converted string.
base	Radix number of number.

TRIO_STRING_PUBLIC int trio_equal_max TRIO_ARGS3	(	(first, max, second)	,
		TRIO_CONST char *	first,
		size_t	max,
		TRIO_CONST char *	second
	)

Compare if two strings up until the first max characters are equal.

Parámetros:

first	First string.
max	Maximum number of characters to compare.
second	Second string.

Devuelve:

Boolean indicating whether the two strings are equal or not.

Case-sensitive comparison.

Compare if two strings up until the first max characters are equal.

Parámetros:

first	First string.
max	Maximum number of characters to compare.
second	Second string.

Devuelve:

Boolean indicating whether the two strings are equal or not.

Case-insensitive comparison.

TRIO_STRING_PUBLIC char* trio_substring_max TRIO_ARGS3	(	(string, max, substring)	,
		TRIO_CONST char *	string,
		size_t	max,
		TRIO_CONST char *	substring
	)

Search for a substring in the first max characters of a string.

Parámetros:

string	String to be searched.
max	Maximum characters to be searched.
substring	String to be found.

Devuelve:

Pointer to first occurrence of substring in string, or NULL if no match was found.

TRIO_STRING_PUBLIC int trio_copy_max TRIO_ARGS3	(	(target, max, source)	,
		char *	target,
		size_t	max,
		TRIO_CONST char *	source
	)

Append at most max characters from source to target.

Parámetros:

target	Target string.
max	Maximum number of characters to append.
source	Source string.

Devuelve:

Boolean value indicating success or failure.

Precondición:

target must point to a memory chuck with sufficient room to contain the target string and the source string (at most max characters).

No boundary checking is performed, so insufficient memory will result in a buffer overrun.

Postcondición:

target will be zero terminated.

Copy at most max characters from source to target.

Parámetros:

target	Target string.
max	Maximum number of characters to append.
source	Source string.

Devuelve:

Boolean value indicating success or failure.

Precondición:

target must point to a memory chunk with sufficient room to contain the source string (at most max characters).

No boundary checking is performed, so insufficient memory will result in a buffer overrun.

Postcondición:

target will be zero terminated.

TRIO_STRING_PUBLIC size_t trio_span_function TRIO_ARGS3	(	(target, source, Function)	,
		char *	target,
		TRIO_CONST char *	source,
		int *Function	TRIO_PROTO(int)
	)

Execute a function on each character in string.

Parámetros:

target	Target string.
source	Source string.
Function	Function to be executed.

Devuelve:

Number of processed characters.

TRIO_STRING_PUBLIC size_t trio_format_date_max TRIO_ARGS4	(	(target, max, format, datetime)	,
		char *	target,
		size_t	max,
		TRIO_CONST char *	format,
		TRIO_CONST struct tm *	datetime
	)

Format the date/time according to format.

Parámetros:

target	Target string.
max	Maximum number of characters to format.
format	Formatting string.
datetime	Date/time structure.

Devuelve:

Number of formatted characters.

The formatting string accepts the same specifiers as the standard C function strftime.