SysUtils

Files
file	psString.h
	Contains the declarations of string utility functions.
Functions
psString	psStringCopy (const char *string)
	Copies the input string.
psString	psStringNCopy (const char *string, unsigned int nChar)
	Copies the input string up to the specified number of characters.
ssize_t	psStringAppend (char **dest, const char *format,...)
	Appends a format onto a string.
ssize_t	psStringPrepend (char **dest, const char *format,...)
	Prepends a format onto a string.

---

Function Documentation

ssize_t psStringAppend (  char **  dest, const char *  format,   ... )

Appends a format onto a string. This function shall allocate a new string if dest is NULL. dest shall be automatically extended to the size of the new string. Returns: The length of the new string (excluding '') Parameters: dest  existing string format  format to append

psString psStringCopy (  const char *  string  )

Copies the input string. This function shall allocate memory to the length of the input string plus one and copy the input string to the newly allocated memory. Returns: psString: Copy of input string Parameters: string  Input string of characters to copy

psString psStringNCopy (  const char *  string, unsigned int  nChar )

Copies the input string up to the specified number of characters. This function shall allocate memory to the length specified by nChar plus one and copy the input string to the newly allocated memory. This function will only copy nChar bytes from the input to new string, so if the input string is larger than nChar characters the copied string will be a substring of the input string. If the input string is smaller than nChar bytes then the remaining bytes allocated will be set to NULL. Returns: psString: Copy of input string Parameters: string  Input string of characters to copy nChar  Number of bytes to allocate for string copy

ssize_t psStringPrepend (  char **  dest, const char *  format,   ... )

Prepends a format onto a string. This function shall allocate a new string if dest is NULL. dest shall be automatically extended to the size of the new string. Returns: The length of the new string (excluding '') Parameters: dest  existing string format  format to append

---