Category

Development Platform
Home > SourceCode/Document > Internet-Socket-Network > Browser Client > View Code
HTParse.h
Package: arena-beta-2b-src.tar.gz　[view]
Upload User: zlh9724
Upload Date: 2007-01-04
Package Size: 1991k
Code Size: 4k
Category:

Browser Client

Development Platform:

Unix_Linux

HTParse.h：Code Content
  1. /*                                                                                URI Parsing
  2.                                        URI PARSING
  3.                                              
  4.  */
  5. /*
  6. **      (c) COPYRIGHT MIT 1995.
  7. **      Please first read the full copyright statement in the file COPYRIGH.
  8. */
  9. /*
  11.    This module contains code to parse URIs and various related things such as:
  12.    
  13.       Parse a URI for tokens
  14.       
  15.       Canonicalization of URIs
  16.       
  17.       Search a URI for illigal characters in order to prevent security holes
  18.       
  19.    This module is implemented by HTParse.c, and it is a part of the  W3C Reference
  20.    Library.
  21.    
  22.  */
  23. #ifndef HTPARSE_H
  24. #define HTPARSE_H
  26. #include "HTEscape.h"
  27. /*
  29. Parsing URIs
  31.    These functions can be used to get information in a URI.
  32.    
  33.   PARSE A URI RELATIVE TO ANOTHER URI
  34.   
  35.    This returns those parts of a name which are given (and requested) substituting bits
  36.    from the related name where necessary. The aName argument is the (possibly relative)
  37.    URI to be parsed, the relatedName is the URI which the aName is to be parsed relative
  38.    to. Passing an empty string means that the aName is an absolute URI. The following are
  39.    flag bits which may be OR'ed together to form a number to give the 'wanted' argument to
  40.    HTParse.
  41.    
  42.  */
  43. #define PARSE_ACCESS            16
  44. #define PARSE_HOST               8
  45. #define PARSE_PATH               4
  46. #define PARSE_ANCHOR             2
  47. #define PARSE_PUNCTUATION        1
  48. #define PARSE_ALL               31
  49. /*
  51.    where the format of a URI is as follows:
  52.    
  53.  */
  54. /*
  55.         ACCESS :// HOST / PATH # ANCHOR
  56. */
  57. /*
  59.    PUNCTUATION means any delimiter like '/', ':', '#' between the tokens above. The string
  60.    returned by the function must be freed by the caller.
  61.    
  62.  */
  63. extern char * HTParse  (CONST char * aName, CONST char * relatedName,
  64.                         int wanted);
  65. /*
  67.   CREATE A RELATIVE (PARTIAL) URI
  68.   
  69.    This function creates and returns a string which gives an expression of one address as
  70.    related to another.  Where there is no relation, an absolute address is retured.
  71.    
  72.   ON ENTRY,
  73.   
  74.    Both names must be absolute, fully qualified names of nodes (no anchor bits)
  75.    
  76.   ON EXIT,
  77.   
  78.    The return result points to a newly allocated name which, if parsed by HTParse relative
  79.    to relatedName, will yield aName. The caller is responsible for freeing the resulting
  80.    name later.
  81.    
  82.  */
  83. extern char * HTRelative (CONST char * aName, CONST char *relatedName);
  84. /*
  86. Canonicalization
  88.    Canonicalization of URIs is a difficult job, but it saves a lot of down loads and
  89.    double entries in the cache if we do a good job. A URI is allowed to contain the
  90.    seqeunce xxx/../ which may be replaced by "" , and the seqeunce "/./" which may be
  91.    replaced by "/".  Simplification helps us recognize duplicate URIs. Thus, the following
  92.    transformations are done:
  93.    
  94.        /etc/junk/../fred
  95.       becomes
  96.       /etc/fred
  97.       
  98.        /etc/junk/./fred
  99.       becomes
  100.       /etc/junk/fred
  101.       
  102.    but we should NOT change
  103.    
  104.        http://fred.xxx.edu/../.. or
  105.       
  106.        ../../albert.html
  107.       
  108.    In the same manner, the following prefixed are preserved:
  109.    
  110.        ./
  111.       
  112.        //
  113.       
  114.    In order to avoid empty URIs the following URIs become:
  115.    
  116.        /fred/..
  117.       
  118.       
  119.       becomes /fred/..
  120.       
  121.        /fred/././..
  122.       
  123.       becomes /fred/..
  124.       
  125.        /fred/.././junk/.././
  126.       becomes /fred/..
  127.       
  128.    If more than one set of `://' is found (several proxies in cascade) then only the part
  129.    after the last `://' is simplified.
  130.    
  131.  */
  132. extern char *HTSimplify (char **filename);
  133. /*
  135. Prevent Security Holes
  137.    In many telnet like protocols, it can be very dangerous to allow a full ASCII character
  138.    set to be in a URI. Therefore we have to strip them out. HTCleanTelnetString() makes
  139.    sure that the given string doesn't contain characters that could cause security holes,
  140.    such as newlines in ftp, gopher, news or telnet URLs; more specifically: allows
  141.    everything between hexadesimal ASCII 20-7E, and also A0-FE, inclusive.
  142.    
  143.   str                     the string that is *modified* if necessary.  The string will be
  144.                              truncated at the first illegal character that is encountered.
  145.                          
  146.   returns                 YES, if the string was modified.      NO, otherwise.
  147.                          
  148.  */
  149. extern BOOL HTCleanTelnetString (char * str);
  150. /*
  152.  */
  153. #endif  /* HTPARSE_H */
  154. /*
  156.    End of HTParse Module */