The xtype C Library, Version 1.00

Contents:

1. fgetxstr
2. xstrcast
3. xstrcat
4. xstrcatc
5. xstrch
6. xstrcpy
7. xstrcvt
8. xstrdel
9. xstrfree
10. xstrlen
11. xstrncat
12. xstrncpy
13. xstrnew
14. xstrtrunc

Function

Read one line of a stream f, terminated by a line feed ('\n') character, into a string pointed to by xstr, as fgets().

Returns

• NULL, if there is an error. If feof(f) and ferror(f) are both false, then there was a memory allocation failure.
• xstr, otherwise.

Function

Concatenate the string pointed to by psz to the end of the string pointed to by xstr, as strcat().

Returns

• NULL, if there was a memory allocation failure. The string pointed to by xstr will not be changed if this is the case.
• xstr, otherwise

Function

Concatenate the character ch to the end of the string pointed to by xstr.

Returns

• NULL, if there was a memory allocation failure. The string pointed to by xstr will not be changed if this is the case.
• xstr, otherwise

Function

Pick out the nth character of the string pointed to by xstr; equivalent to xstrcast(xstr)[n]. xstrch() is implemented as a macro.

Returns

• The character in position n in the string pointed to by xstr.

Function

Copy the string pointed to by psz into the string pointed to by xstr, as strcpy().

Returns

• NULL, if there was a memory allocation failure. The string pointed to by xstr will not be changed if this is the case.
• xstr, otherwise

Function

Convert the string pointed to by xstr into a normal null-terminated character string. All the memory associated with xstr will be de-allocated, so do not use xstr after calling this function. The pointer returned should be freed with free() when it is no longer required.

Returns

• A pointer to a null-terminated character string containing the string pointed to by xstr.

Function

Shorten the string pointed to by xstr by removing characters n1 to n2, inclusive.

Returns

• xstr.

Function

De-allocate the memory used by the string pointed to by xstr. Do not use xstr after calling this function.

Function

Compute the length of the string pointed to by xstr, equivalent to strlen(xstrcast(xstr)). xstrlen() is implemented as a macro.

Returns

• The number of characters in the string pointed to by xstr.

Function

Concatenate at most n characters from the string pointed to by psz to the string pointed to by xstr. Unlike strncat(), this function will ensure that the resulting string is null-terminated.

Returns

• NULL, if there was a memory allocation failure. The string pointed to by xstr will not be changed if this is the case.
• xstr, otherwise

Function

Copy at most n characters from the string pointed to by psz into the string pointed to by xstr. Unlike strncpy(), this function will ensure that the resulting string is null-terminated.

Returns

• NULL, if there was a memory allocation failure. The string pointed to by xstr will not be changed if this is the case.
• xstr, otherwise

Function

Create a new string with initial space for n characters. The space allocated for the string will grow by b characters whenever the string exceeds the length currently set aside for it.

Returns

• NULL, if there was a memory allocation failure.
• a pointer to the newly-created string, otherwise, which can be de-allocated by using xstrfree(), or xstrcvt() and free().

Function

Truncate the string pointed to by xstr to be no longer than n characters. If the length of xstr is less than n, this function does nothing.

Returns

• xstr.