Category

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

Browser Client

Development Platform:

Unix_Linux

HTWWWStr.h：Code Content
  1. /*                                                                            String Handling
  2.                               WWW RELATED STRING MANAGEMENT
  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 is like the generic string utility module but it contains more Web related
  12.    string utility functions. This module is implemented by HTWWWStr.c, and it is a part of
  13.    the  W3C Reference Library.
  14.    
  15.  */
  16. #ifndef HTWWWSTR_H
  17. #define HTWWWSTR_H
  18. /*
  20. Next word or quoted string
  22.    This function returns a RFC822 word separated by space, comma, or semi-colons. pstr
  23.    points to a string containing a word separated by white white space "," ";" or "=". The
  24.    word can optionally be quoted using  or "" Comments surrrounded by '(' ')' are filtered
  25.    out. On exit, pstr has been moved to the first delimiter past the field THE STRING HAS
  26.    BEEN MUTILATED by a 0 terminator.  The function returns a pointer to the first word or
  27.    NULL on error
  28.    
  29.  */
  30. extern char * HTNextField (char** pstr);
  31. /*
  33. RFC1123 Date/Time Stamp String
  35.    Returns a pointer to a static area!
  36.    
  37.  */
  38. extern CONST char *HTDateTimeStr (time_t *calendar, BOOL local);
  39. /*
  41. Date used for directory listings
  43.  */
  44. extern BOOL HTDateDirStr (time_t * time, char * str, int len);
  45. /*
  47. Timezone Offset
  49.    Calculates the offset from GMT in seconds. This is called from HTLibInit().
  50.    
  51.  */
  52. extern long HTGetTimeZoneOffset (void);
  53. /*
  55. Parse a Date/Time String
  57.    Converts a string representation in GMT to a local representation of localtime time_t.
  58.    
  59.  */
  60. extern time_t HTParseTime (CONST char * str);
  61. /*
  63. Unique Message-ID String
  65.  */
  66. extern CONST char *HTMessageIdStr (void);
  67. /*
  69. Converts an Integer to a String using Prefix
  71.    In computer-world 1K is 1024 bytes and 1M is 1024K -- however, sprintf() still formats
  72.    in base-10.  Therefore I output only until 999, and then start using the next unit.
  73.    This doesn't work wrong, it's just a feature.  The conversion is done in "str" which
  74.    must be large enough to contain the result.
  75.    
  76.  */
  77. extern void HTNumToStr (unsigned long n, char *str, int len);
  78. /*
  80. Conversion between URLs and Local File Names
  82.    These are two functions that separate the URL naming syntax from platform dependent
  83.    file naming schemes. If you are porting the code to a new platform, you probably have
  84.    to do some translation here.
  85.    
  86.   CONVERT FILE URLS INTO A LOCAL REPRESENTATION
  87.   
  88.    The URL has already been translated through the rules in get_physical in HTAccess.c and
  89.    all we need to do now is to map the path to a local representation, for example if must
  90.    translate '/' to the ones that turn the wrong way ;-) Returns local file (that must be
  91.    freed by caller) if OK, else NULL.
  92.    
  93.  */
  94. extern char * HTWWWToLocal (CONST char * url, CONST char * base);
  95. /*
  97.   CONVERT A LOCAL FILE NAME INTO A URL
  98.   
  99.    Generates a WWW URL name from a local file name or NULL if error. Returns URL (that
  100.    must be freed by caller) if OK, else NULL.
  101.    
  102.  */
  103. extern char * HTLocalToWWW (CONST char * local);
  104. /*
  106.  */
  107. #endif
  108. /*
  110.    End of declaration module  */