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)
