Wizard\

AcquireString • AcquireStringInfo • BlobToStringInfo • CloneString • CloneStringInfo • CompareStringInfo • ConcatenateString • ConcatenateWizardString • ConfigureFileToStringInfo • ConstantString • ConcatenateStringInfo • CopyWizardString • DestroyString • DestroyStringInfo • DestroyStringList • FileToString • FileToStringInfo • FormatWizardSize • FormatWizardTime • GetEnvironmentValue • GetStringInfoCRC • GetStringInfoDatum • GetStringInfoLength • GetStringInfoPath • HexStringToStringInfo • LocaleCompare • LocaleLower • LocaleNCompare • PrintWizardString • PrintStringInfo • ResetStringInfo • SetStringInfo • SetStringInfoDatum • SetStringInfoLength • SetStringInfoPath • SplitStringInfo • StringInfoToHexString • StringInfoToString • StringToArgv • StringToStringInfo • StripString • SubstituteString

AcquireString

AcquireString() returns an new extented string, containing a clone of the given string.

An extended string is the string length, plus an extra WizardPathExtent space to allow for the string to be activally worked on.

The format of the AcquireString method is:

char *AcquireString(const char *source)

A description of each parameter follows:

source: A character string.

AcquireStringInfo

AcquireStringInfo() allocates the StringInfo structure.

The format of the AcquireStringInfo method is:

StringInfo *AcquireStringInfo(const size_t length)

A description of each parameter follows:

length: The string length.

BlobToStringInfo

BlobToStringInfo() returns the contents of a blob as a string.

The format of the BlobToStringInfo method is:

StringInfo *BlobToStringInfo(const void *blob,const size_t length)

A description of each parameter follows:

blob: the blob.
length: the length of the blob.

CloneString

CloneString() allocates memory for the destination string and copies the source string to that memory location.

The format of the CloneString method is:

char *CloneString(char **destination,const char *source)

A description of each parameter follows:

destination: A pointer to a character string.
source: A character string.

CloneStringInfo

CloneStringInfo() clones a copy of the StringInfo structure.

The format of the CloneStringInfo method is:

StringInfo *CloneStringInfo(const StringInfo *string_info)

A description of each parameter follows:

string_info: The string info.

CompareStringInfo() compares the two datums target and source. It returns an integer less than, equal to, or greater than zero if target is found, respectively, to be less than, to match, or be greater than source.

The format of the CompareStringInfo method is:

int CompareStringInfo(const StringInfo *target,const StringInfo *source)

A description of each parameter follows:

target: The target string.
source: The source string.

ConcatenateString

ConcatenateString() appends a copy of string source, including the terminating null character, to the end of string destination.

The format of the ConcatenateString method is:

WizardBooleanType ConcatenateString(char **destination,
  const char *source)

A description of each parameter follows:

destination: A pointer to a character string.
source: A character string.

ConcatenateWizardString

ConcatenateWizardString() concatenates the source string to the destination string. The destination buffer is always null-terminated even if the string must be truncated.

The format of the ConcatenateWizardString method is:

size_t ConcatenateWizardString(char *destination,const char *source,
  const size_t length)

A description of each parameter follows:

destination: The destination string.
source: The source string.
length: The length of the destination string.

ConfigureFileToStringInfo

ConfigureFileToStringInfo() returns the contents of a configure file as a string.

The format of the ConfigureFileToStringInfo method is:

StringInfo *ConfigureFileToStringInfo(const char *filename)
  ExceptionInfo *exception)

A description of each parameter follows:

filename: The filename.

ConstantString

ConstantString() allocates memory for a string and copies the source string to that memory location (and returns it). Use it for strings that you do do not expect to change over its lifetime.

The format of the ConstantString method is:

char *ConstantString(const char *source)

A description of each parameter follows:

source: A character string.

ConcatenateStringInfo

ConcatenateStringInfo() concatenates the source string to the destination string.

The format of the ConcatentateStringInfo method is:

void ConcatentateStringInfo(StringInfo *string_info,
  const StringInfo *source)

A description of each parameter follows:

string_info: The string info.
source: The source string.

CopyWizardString

CopyWizardString() copies the source string to the destination string. The destination buffer is always null-terminated even if the string must be truncated. The return value is the minimum of the ource string length or the length parameter.

The format of the CopyWizardString method is:

size_t CopyWizardString(const char *destination,char *source,
  const size_t length)

A description of each parameter follows:

destination: The destination string.
source: The source string.
length: The length of the destination string.

DestroyString

DestroyString() destorys memory associated with a string.

The format of the DestroyString method is:

char *DestroyString(char *string)

A description of each parameter follows:

string: The string.

DestroyStringInfo

DestroyStringInfo() zeros memory associated with the StringInfo structure.

The format of the DestroyStringInfo method is:

StringInfo *DestroyStringInfo(StringInfo *string_info)

A description of each parameter follows:

string_info: The string info.

DestroyStringList

DestroyStringList() zeros memory associated with a string list.

The format of the DestroyStringList method is:

char **DestroyStringList(char **list)

A description of each parameter follows:

list: The string list.

FileToString

FileToString() returns the contents of a file as a string.

The format of the FileToString method is:

char *FileToString(const char *filename,const size_t extent,
  ExceptionInfo *exception)

A description of each parameter follows:

filename: The filename.
extent: Maximum length of the string.
exception: Return any errors or warnings in this structure.

FileToStringInfo

FileToStringInfo() returns the contents of a file as a string.

The format of the FileToStringInfo method is:

StringInfo *FileToStringInfo(const char *filename,const size_t extent,
  ExceptionInfo *exception)

A description of each parameter follows:

filename: The filename.
extent: Maximum length of the string.
exception: Return any errors or warnings in this structure.

FormatWizardSize

FormatWizardSize() converts a size to a human readable format, for example, 14k, 234m, 2.7g, or 3.0t. Scaling is done by repetitively dividing by 1000.

The format of the FormatWizardSize method is:

ssize_t FormatWizardSize(const WizardSizeType size,
  const WizardBooleanType bi,const size_t length,char *format)

A description of each parameter follows:

size: convert this size to a human readable format.
bi: use power of two rather than power of ten.
length: The maximum length of the string.
format: human readable format.

FormatWizardTime

FormatWizardTime() returns the specified time in the Internet date/time format and the length of the timestamp.

The format of the FormatWizardTime method is:

ssize_t FormatWizardTime(const time_t time,const size_t length,
  char *timestamp)

A description of each parameter follows.

time

the time since the Epoch (00:00:00 UTC, January 1, 1970), measured in seconds.

length

The maximum length of the string.

timestamp

Return the Internet date/time here.

GetEnvironmentValue

GetEnvironmentValue() returns the environment string that matches the specified name.

The format of the GetEnvironmentValue method is:

char *GetEnvironmentValue(const char *name)

A description of each parameter follows:

name: the environment name.

GetStringInfoCRC

GetStringInfoCRC() returns the CRC-64 of a string.

The format of the GetStringInfo method is:

WizardSizeType GetStringInfo(const StringInfo *string_info)

A description of each parameter follows:

string_info: The string info.

GetStringInfoDatum

GetStringInfoDatum() returns the datum associated with the string.

The format of the GetStringInfoDatum method is:

unsigned char *GetStringInfoDatum(const StringInfo *string_info)

A description of each parameter follows:

string_info: the string info.

GetStringInfoLength

GetStringInfoLength() returns the string length.

The format of the GetStringInfoLength method is:

size_t GetStringInfoLength(const StringInfo *string_info)

A description of each parameter follows:

string_info: the string info.

GetStringInfoPath

GetStringInfoPath() returns the path associated with the string.

The format of the GetStringInfoPath method is:

const char *GetStringInfoPath(const StringInfo *string_info)

A description of each parameter follows:

string_info: the string info.

HexStringToStringInfo

HexStringToStringInfo() converts a string to a StringInfo type.

The format of the HexStringToStringInfo method is:

StringInfo *HexStringToStringInfo(const char *string)

A description of each parameter follows:

string: The string.

LocaleCompare

LocaleCompare() performs a case-insensitive comparison of two strings byte-by-byte, according to the ordering of the current locale encoding. LocaleCompare returns an integer greater than, equal to, or less than 0, if the string pointed to by p is greater than, equal to, or less than the string pointed to by q respectively. The sign of a non-zero return value is determined by the sign of the difference between the values of the first pair of bytes that differ in the strings being compared.

The format of the LocaleCompare method is:

int LocaleCompare(const char *p,const char *q)

A description of each parameter follows:

p: A pointer to a character string.
q: A pointer to a character string to compare to p.

LocaleLower

LocaleLower() transforms all of the characters in the supplied null-terminated string, changing all uppercase letters to lowercase.

The format of the LocaleLower method is:

void LocaleLower(char *string)

A description of each parameter follows:

string: A pointer to the string to convert to lower-case Locale.

LocaleNCompare

LocaleNCompare() performs a case-insensitive comparison of two strings byte-by-byte, according to the ordering of the current locale encoding. LocaleNCompare returns an integer greater than, equal to, or less than 0, if the string pointed to by p is greater than, equal to, or less than the string pointed to by q respectively. The sign of a non-zero return value is determined by the sign of the difference between the values of the first pair of bytes that differ in the strings being compared. The LocaleNCompare method makes the same comparison as LocaleCompare but looks at a maximum of n bytes. Bytes following a null byte are not compared.

The format of the LocaleNCompare method is:

int LocaleNCompare(const char *p,const char *q,const size_t n)

A description of each parameter follows:

p: A pointer to a character string.
q: A pointer to a character string to compare to p.
length: The number of characters to compare in strings p and q.

PrintWizardString

PrintWizardString() prints the string to the specified file.

The format of the PrintWizardString method is:

ssize_t PrintWizardString(FILE *,const char *format,...)

A description of each parameter follows:

file: print to this file.
format: A string describing the format to use to write the remaining arguments.

PrintStringInfo

PrintStringInfo() prints the string.

The format of the PrintStringInfo method is:

void PrintStringInfo(FILE *file,const char *id,
  const StringInfo *string_info)

A description of each parameter follows:

id: The string id.
string_info: The string info.

ResetStringInfo

ResetStringInfo() reset the string to all null bytes.

The format of the ResetStringInfo method is:

void ResetStringInfo(StringInfo *string_info)

A description of each parameter follows:

string_info: The string info.

SetStringInfo

SetStringInfo() copies the source string to the destination string.

The format of the SetStringInfo method is:

void SetStringInfo(StringInfo *string_info,const StringInfo *source)

A description of each parameter follows:

string_info: The string info.
source: The source string.

SetStringInfoDatum

SetStringInfoDatum() copies bytes from the source string for the length of the destination string.

The format of the SetStringInfoDatum method is:

void SetStringInfoDatum(StringInfo *string_info,
  const unsigned char *source)

A description of each parameter follows:

string_info: The string info.
source: The source string.

SetStringInfoLength

SetStringInfoLength() set the string length to the specified value.

The format of the SetStringInfoLength method is:

void SetStringInfoLength(StringInfo *string_info,const size_t length)

A description of each parameter follows:

string_info: The string info.
length: The string length.

SetStringInfoPath

SetStringInfoPath() sets the path associated with the string.

The format of the SetStringInfoPath method is:

void SetStringInfoPath(StringInfo *string_info,const char *path)

A description of each parameter follows:

string_info: The string info.
path: The path.

SplitStringInfo

SplitStringInfo() splits a string into two and returns it.

The format of the SplitStringInfo method is:

StringInfo *SplitStringInfo(StringInfo *string_info,const size_t offset)

A description of each parameter follows:

string_info: The string info.

StringInfoToHexString

StringInfoToHexString() converts a string info string to a C string.

The format of the StringInfoToHexString method is:

char *StringInfoToHexString(const StringInfo *string_info)

A description of each parameter follows:

string_info: The string.

StringInfoToString

StringInfoToString() converts a string info string to a C string.

The format of the StringInfoToString method is:

char *StringInfoToString(const StringInfo *string_info)

A description of each parameter follows:

string_info: The string.

StringToArgv

StringToArgv() converts a text string into command line arguments.

The format of the StringToArgv method is:

char **StringToArgv(const char *text,int *argc)

A description of each parameter follows:

argv: Method StringToArgv returns the string list unless an error occurs, otherwise NULL.
text: Specifies the string to segment into a list.
argc: This integer pointer returns the number of arguments in the list.

StringToStringInfo

StringToStringInfo() converts a string to a StringInfo type.

The format of the StringToStringInfo method is:

StringInfo *StringToStringInfo(const char *string)

A description of each parameter follows:

string: The string.

StripString

StripString() strips any whitespace or quotes from the beginning and end of a string of characters.

The format of the StripString method is:

void StripString(char *message)

A description of each parameter follows:

message: Specifies an array of characters.

SubstituteString

SubstituteString() performs string substitution on a string, replacing the string with the substituted version. Buffer must be allocated from the heap. If the string is matched and status, WizardTrue is returned otherwise WizardFalse.

The format of the SubstituteString method is:

WizardBooleanType SubstituteString(char **string,const char *search,
  const char *replace)

A description of each parameter follows:

string: the string to perform replacements on; replaced with new allocation if a replacement is made.
search: search for this string.
replace: replace any matches with this string.