git.maemo.org Git - erwise/blob - Cl/WWWLibrary/HTParse.h

   1 /*              Parse HyperText Document Address                HTParse.h
   2 **              ================================
   3 */
   4 /*      These are flag bits which may be ORed together to form a number to give
   5 **      the 'wanted' argument to HTParse.
   6 */
   7 #define PARSE_ACCESS            16
   8 #define PARSE_HOST               8
   9 #define PARSE_PATH               4
  10 #define PARSE_ANCHOR             2
  11 #define PARSE_PUNCTUATION        1
  12 #define PARSE_ALL               31
  13
  14 /*      Parse a Name relative to another name
  15 **      -------------------------------------
  16 **
  17 **      This returns those parts of a name which are given (and requested)
  18 **      substituting bits from the related name where necessary.
  19 **
  20 ** On entry,
  21 **      aName           A filename given
  22 **      relatedName     A name relative to ehich aName is to be parsed
  23 **      wanted          A mask for the bits which are wanted.
  24 **
  25 ** On exit,
  26 **      returns         A pointer to a malloc'd string which MUST BE FREED
  27 */
  28 #ifdef __STDC__
  29 extern char * HTParse(const char * aName, const char * relatedName, int wanted);
  30 #else
  31 extern char * HTParse();
  32 #endif
  33
  34 /*      Strip white space off a string
  35 **      ------------------------------
  36 **
  37 ** On exit,
  38 **      Return value points to first non-white character, or to 0 if none.
  39 **      All trailing white space is OVERWRITTEN with zero.
  40 */
  41 #ifdef __STDC__
  42 extern char * HTStrip(char * s);
  43 #else
  44 extern char * HTStrip();
  45 #endif
  46
  47 /*              Simplify a filename
  48 **              -------------------
  49 **
  50 **      A unix-style file is allowed to contain the seqeunce xxx/../ which
  51 **      may be replaced by "" , and the seqeunce "/./" which may be replaced
  52 **      by "/".
  53 **      Simplification helps us recognize duplicate filenames. It doesn't deal
  54 **      with soft links, though.
  55 **      The new (shorter) filename overwrites the old.
  56 **
  57 **      Thus,   /etc/junk/../fred       becomes /etc/fred
  58 **              /etc/junk/./fred        becomes /etc/junk/fred
  59 */
  60 #ifdef __STDC__
  61 extern void HTSimplify(char * filename);
  62 #else
  63 extern void HTSimplify();
  64 #endif
  65
  66 /*              Make Relative Name
  67 **              ------------------
  68 **
  69 **      This function creates and returns a string which gives an expression of
  70 **      one address as related to another. Where there is no relation, an
  71 **      absolute address is retured.
  72 **
  73 **  On entry,
  74 **      Both names must be absolute, fully qualified names of nodes
  75 **      (no anchor bits)
  76 **
  77 **  On exit,
  78 **      The return result points to a newly allocated name which, if parsed
  79 **      by HTParse relative to relatedName, will yield aName. The caller is
  80 **      responsible for freeing the resulting name later.
  81 **
  82 */
  83 #ifdef __STDC__
  84 extern char * HTRelative(const char * aName, const char *relatedName);
  85 #else
  86 extern char * HTRelative();
  87 #endif