NAME
stConvertPattern, stSubstituteString, stStrtok, stStrEnter - string
handling
SYNOPSIS
#include <config.h>
#include <sttk.h>
char* stConvertPattern (char *pattern);
char* stSubstituteString (char *original, char *old, char *new);
char* stStrtok (char *string);
char* stStrEnter (char *string);
DESCRIPTION
stConvertPattern converts sh(1) filename generation patterns to ed(1)
string patterns.
question (?)
gets converted to period (.)
asterisk (*)
gets converted to a period followed by an asterisk (.*)
period (.)
will be escaped by a backslash character (\.).
exclam (!)
gets converted to circumflex (^) if it follows an left bracket
([). Otherwise it remains unmodified.
The whole pattern will be enclosed in a circumflex (^) as leftmost an a
dollar sign ($) as rightmost character.
stSubstituteString replaces all occurrences of substring old in
original by string new. It returns a pointer to an allocated string
that is the result of this operation. Returns NULL if anything goes
seriously wrong.
stStrtok considers the string string to consist of a sequence of zero
or more text tokens separated by whitespace. The first call (with
pointer string specified) returns a pointer to the first character of
the first token, and will have written a null character into string
immediately following the returned token. The function keeps track of
its position between separate calls, so that subsequent calls (which
must be made with the string argument set to NULL) will work through
the string immediately following that token. In this way subsequent
calls will work through the string until no tokens remain. When no
token remains in string, a NULL pointer is returned.
stStrEnter adds the given string to an internal string table and
returns a pointer to appropriate string table entry. Equal strings are
mapped to equal locations in the table. Equality of two strings in the
string table can be checked by simple pointer comparison.
SEE ALSO
sh (1), ed (1)