   ____  _        
  / ___|| |_ _ __ 
  \___ \| __| '__|
   ___) | |_| |   
  |____/ \__|_|   
                
  Str - String Library                 

  TODO
   
  The following *have* to be done before 1.0.0:

  o use stdio-style "t" strings insead of STR_TRIGRAPH bitmasks
  o finish str_test.c: more tests
  o Dean wrote: btw -- str_compare taking a mode argument doesn't let you trim a few
    cycles by going into strcmp/strcasecmp which are usually hand-tuned
    assembly beasts on most boxes.  i'd go for str_compare and
    str_casecompare.

  The following *could* be done before 1.0.0:

  o str_encode/str_decode:
    - plain base64
    - strict base64 (with newlines and padding, etc.)
  o str to/from symbol conversion:
    - long str_symbol(char *str);
  o str_format merged with strptime
  o str_locate could become a "mode" argument which
    indicates whether "s" is small or large and if
    it is small a (faster) brute force search could be done.
  o str_parse could support s/.../g or even m/.../g 
  o one could add "vstr" support with own malloc
    Dean wrote: have you seen djb's stralloc stuff? it's part of qmail.
    it looks like a nice way to avoid thinking about lengths.

