Home

This library provides various string handling functions:

===Empty string tests===

• int [isempty] (char *strarg) - Returns true if strarg is empty, otherwise returns false
• int [notempty] (char *strarg) - Returns true if string is populated, otherwise returns false

===Prefix handlers===

• int [countprefixalphas] (char *strarg) - Gives number of alphabetic characters at start of string
• int [countprefixalnums] (char *strarg) - Gives number of alphanumeric characters at start of string
• int [countprefixdigits] (char *strarg) - Gives number of digits at start of string

===String matching===

• int [strbegins] (char * strarg , char *strsrc) - Returns number of characters matched if strsrc begins with strarg, zero for empty string match, (negative on no match or error)
• int [strbeginsi] (char * strarg , char *strsrc) - Like [strbegins] , but [lettercase] insensitive.
• int [strbeginsfield] (char * strarg , char fs, char * strsrc) - Returns number of characters matched if first field in strsrc matches strarg, zero for empty string match, (negative on no match or error). The fs character is a field separator
• int [strbeginsfieldi] (char * strarg , char fs, char * strsrc) - Like [strbeginsfield] , but [lettercase] insensitive.

===Field functions===

• int [longestfieldlen] (char * strarg, char fs) - Returns length of longest field in strarg

===Basic strz handling===

These functions are provided for handling [strz] data blocks:

• int [countstrz] (char * strzaddr) - Gives the number of nonempty consecutive [strz] values (-1 on error)
• int [getstrzoffset] (int strnum, char * strzaddr) - Returns the offset of the specified [strz] number from startpoint (-1 on error)
• char * [getstrzaddr] (int strnum, char * strzaddr) - Returns the address of specified [strz] number from startpoint (NULL on error)
• char * [getstrzaddrbegins] (int, char * , char *) - Returns the address of the first string from [strz] startpoint provided as third parameter (or NULL if no match or error)
• char * [getstrzaddrbeginsi] (int, char * , char *) - Like [getstrzoffsetbegins], but [lettercase] insensitive
• int [getstrzoffsetbegins] (int, char * , char *) - Returns the offset of the first string from [strz] startpoint provided as third parameter, or negative on no match or error
• int [getstrzoffsetbeginsi] (int, char * , char *) - Like [getstrzoffsetbegins], but [lettercase] insensitive

===Return values===

• return values

Project Members:

• Mark Hobley (admin)