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)