Annotation of libwww/Library/src/HTParse.c, revision 2.0

1.1       timbl       1: /*             Parse HyperText Document Address                HTParse.c
                      2: **             ================================
                      3: */
                      4: 
                      5: #include "HTUtils.h"
                      6: #include "HTParse.h"
                      7: #include "tcp.h"
                      8: 
                      9: struct struct_parts {
                     10:        char * access;
                     11:        char * host;
                     12:        char * absolute;
                     13:        char * relative;
                     14: /*     char * search;          no - treated as part of path */
                     15:        char * anchor;
                     16: };
                     17: 
                     18: 
                     19: /*     Strip white space off a string
                     20: **     ------------------------------
                     21: **
                     22: ** On exit,
                     23: **     Return value points to first non-white character, or to 0 if none.
                     24: **     All trailing white space is OVERWRITTEN with zero.
                     25: */
                     26: 
                     27: #ifdef __STDC__
                     28: char * HTStrip(char * s)
                     29: #else
                     30: char * HTStrip(s)
                     31:        char *s;
                     32: #endif
                     33: {
                     34: #define SPACE(c) ((c==' ')||(c=='\t')||(c=='\n')) 
                     35:     char * p=s;
                     36:     for(p=s;*p;p++);                   /* Find end of string */
                     37:     for(p--;p>=s;p--) {
                     38:        if(SPACE(*p)) *p=0;     /* Zap trailing blanks */
                     39:        else break;
                     40:     }
                     41:     while(SPACE(*s))s++;       /* Strip leading blanks */
                     42:     return s;
                     43: }
                     44: 
                     45: 
                     46: /*     Scan a filename for its consituents
                     47: **     -----------------------------------
                     48: **
                     49: ** On entry,
                     50: **     name    points to a document name which may be incomplete.
                     51: ** On exit,
                     52: **      absolute or relative may be nonzero (but not both).
                     53: **     host, anchor and access may be nonzero if they were specified.
                     54: **     Any which are nonzero point to zero terminated strings.
                     55: */
                     56: #ifdef __STDC__
                     57: PRIVATE void scan(char * name, struct struct_parts *parts)
                     58: #else
                     59: PRIVATE void scan(name, parts)
                     60:     char * name;
                     61:     struct struct_parts *parts;
                     62: #endif
                     63: {
                     64:     char * after_access;
                     65:     char * p;
                     66:     int length = strlen(name);
                     67:     
                     68:     parts->access = 0;
                     69:     parts->host = 0;
                     70:     parts->absolute = 0;
                     71:     parts->relative = 0;
                     72:     parts->anchor = 0;
                     73:     
                     74:     after_access = name;
                     75:     for(p=name; *p; p++) {
                     76:        if (*p==':') {
                     77:                *p = 0;
                     78:                parts->access = name;   /* Access name has been specified */
                     79:                after_access = p+1;
                     80:        }
                     81:        if (*p=='/') break;
                     82:        if (*p=='#') break;
                     83:     }
                     84:     
                     85:     for(p=name+length-1; p>=name; p--) {
                     86:        if (*p =='#') {
                     87:            parts->anchor=p+1;
                     88:            *p=0;                               /* terminate the rest */
                     89:        }
                     90:     }
                     91:     p = after_access;
                     92:     if (*p=='/'){
                     93:        if (p[1]=='/') {
                     94:            parts->host = p+2;          /* host has been specified      */
                     95:            *p=0;                       /* Terminate access             */
                     96:            p=strchr(parts->host,'/');  /* look for end of host name if any */
                     97:            if(p) {
                     98:                *p=0;                   /* Terminate host */
                     99:                parts->absolute = p+1;          /* Root has been found */
                    100:            }
                    101:        } else {
                    102:            parts->absolute = p+1;              /* Root found but no host */
                    103:        }           
                    104:     } else {
                    105:         parts->relative = (*after_access) ? after_access : 0;  /* zero for "" */
                    106:     }
                    107: 
                    108:     /* Access specified but no host: the anchor was not really one
                    109:        e.g. news:j462#36487@foo.bar -- JFG 10/7/92, from bug report */
                    110:     if (parts->access && ! parts->host && parts->anchor) {
                    111:       *(parts->anchor - 1) = '#';  /* Restore the '#' in the address */
                    112:       parts->anchor = 0;
                    113:     }
                    114: 
                    115: #ifdef NOT_DEFINED     /* search is just treated as part of path */
                    116:     {
                    117:         char *p = relative ? relative : absolute;
                    118:        if (p) {
                    119:            char * q = strchr(p, '?');  /* Any search string? */
                    120:            if (q) {
                    121:                *q = 0;                 /* If so, chop that off. */
                    122:                parts->search = q+1;
                    123:            }
                    124:        }
                    125:     }
                    126: #endif
                    127: } /*scan */    
                    128: 
                    129: 
                    130: /*     Parse a Name relative to another name
                    131: **     -------------------------------------
                    132: **
                    133: **     This returns those parts of a name which are given (and requested)
                    134: **     substituting bits from the related name where necessary.
                    135: **
                    136: ** On entry,
                    137: **     aName           A filename given
                    138: **      relatedName     A name relative to which aName is to be parsed
                    139: **      wanted          A mask for the bits which are wanted.
                    140: **
                    141: ** On exit,
                    142: **     returns         A pointer to a malloc'd string which MUST BE FREED
                    143: */
                    144: #ifdef __STDC__
                    145: char * HTParse(const char * aName, const char * relatedName, int wanted)
                    146: #else
                    147: char * HTParse(aName, relatedName, wanted)
                    148:     char * aName;
                    149:     char * relatedName;
                    150:     int wanted;
                    151: #endif
                    152: 
                    153: {
                    154:     char * result = 0;
                    155:     char * return_value = 0;
                    156:     int len;
                    157:     char * name = 0;
                    158:     char * rel = 0;
                    159:     char * p;
                    160:     struct struct_parts given, related;
                    161:     
                    162:     /* Make working copies of input strings to cut up:
                    163:     */
                    164:     len = strlen(aName)+strlen(relatedName)+10;
                    165:     result=(char *)malloc(len);                /* Lots of space: more than enough */
                    166:     if (result == NULL) outofmem(__FILE__, "HTParse");
                    167:     
                    168:     StrAllocCopy(name, aName);
                    169:     StrAllocCopy(rel, relatedName);
                    170:     
                    171:     scan(name, &given);
                    172:     scan(rel,  &related); 
                    173:     result[0]=0;               /* Clear string  */
                    174:     if (wanted & PARSE_ACCESS)
                    175:         if (given.access|| related.access) {
                    176:            strcat(result, given.access ? given.access : related.access);
                    177:            if(wanted & PARSE_PUNCTUATION) strcat(result, ":");
                    178:        }
                    179:        
                    180:     if (given.access && related.access)        /* If different, inherit nothing. */
                    181:         if (strcmp(given.access, related.access)!=0) {
                    182:            related.host=0;
                    183:            related.absolute=0;
                    184:            related.relative=0;
                    185:            related.anchor=0;
                    186:        }
                    187:        
                    188:     if (wanted & PARSE_HOST)
                    189:         if(given.host || related.host) {
                    190:            if(wanted & PARSE_PUNCTUATION) strcat(result, "//");
                    191:            strcat(result, given.host ? given.host : related.host);
                    192:        }
                    193:        
                    194:     if (given.host && related.host)  /* If different hosts, inherit no path. */
                    195:         if (strcmp(given.host, related.host)!=0) {
                    196:            related.absolute=0;
                    197:            related.relative=0;
                    198:            related.anchor=0;
                    199:        }
                    200:        
                    201:     if (wanted & PARSE_PATH) {
                    202:         if(given.absolute) {                           /* All is given */
                    203:            if(wanted & PARSE_PUNCTUATION) strcat(result, "/");
                    204:            strcat(result, given.absolute);
                    205:        } else if(related.absolute) {   /* Adopt path not name */
                    206:            strcat(result, "/");
                    207:            strcat(result, related.absolute);
                    208:            if (given.relative) {
                    209:                p = strchr(result, '?');        /* Search part? */
                    210:                if (!p) p=result+strlen(result)-1;
                    211:                for (; *p!='/'; p--);   /* last / */
                    212:                p[1]=0;                                 /* Remove filename */
                    213:                strcat(result, given.relative);         /* Add given one */
                    214:                HTSimplify (result);
                    215:            }
                    216:        } else if(given.relative) {
                    217:            strcat(result, given.relative);             /* what we've got */
                    218:        } else if(related.relative) {
                    219:            strcat(result, related.relative);
                    220:        } else {  /* No inheritance */
                    221:            strcat(result, "/");
                    222:        }
                    223:     }
                    224:                
                    225:     if (wanted & PARSE_ANCHOR)
                    226:         if(given.anchor || related.anchor) {
                    227:            if(wanted & PARSE_PUNCTUATION) strcat(result, "#");
                    228:            strcat(result, given.anchor ? given.anchor : related.anchor);
                    229:        }
                    230:     free(rel);
                    231:     free(name);
                    232:     
                    233:     StrAllocCopy(return_value, result);
                    234:     free(result);
                    235:     return return_value;               /* exactly the right length */
                    236: }
                    237: 
                    238: /*             Simplify a filename
                    239: //             -------------------
                    240: //
                    241: // A unix-style file is allowed to contain the seqeunce xxx/../ which may be
                    242: // replaced by "" , and the seqeunce "/./" which may be replaced by "/".
                    243: // Simplification helps us recognize duplicate filenames.
                    244: //
                    245: //     Thus,   /etc/junk/../fred       becomes /etc/fred
                    246: //             /etc/junk/./fred        becomes /etc/junk/fred
                    247: */
                    248: #ifdef __STDC__
                    249: void HTSimplify(char * filename)
                    250: #else
                    251: void HTSimplify(filename)
                    252:     char * filename;
                    253: #endif
                    254: 
                    255: {
                    256:     char * p;
                    257:     char * q;
                    258:     for(p=filename+2; *p; p++) {
                    259:         if (*p=='/') {
                    260:            if ((p[1]=='.') && (p[2]=='.') && (p[3]=='/' || !p[3] )) {
                    261:                for (q=p-1; (q>filename) && (*q!='/'); q--); /* prev slash */
                    262:                if (*q=='/') {
                    263:                    strcpy(q, p+3);     /* Remove  /xxx/..      */
                    264:                    if (!*filename) strcpy(filename, "/");
                    265:                    p = q-1;            /* Start again with prev slash  */
                    266:                } else {                        /*   xxx/..     error?  */
                    267:                    strcpy(filename, p[3] ? p+4 : p+3); /* rm  xxx/../  */
                    268:                    p = filename;               /* Start again */
                    269:                }
                    270:            } else if ((p[1]=='.') && (p[2]=='/' || !p[2])) {
                    271:                strcpy(p, p+2);                 /* Remove a slash and a dot */
                    272:            }
                    273:        }
                    274:     }
                    275: }
                    276: 
                    277: 
                    278: /*             Make Relative Name
                    279: **             ------------------
                    280: **
                    281: ** This function creates and returns a string which gives an expression of
                    282: ** one address as related to another. Where there is no relation, an absolute
                    283: ** address is retured.
                    284: **
                    285: **  On entry,
                    286: **     Both names must be absolute, fully qualified names of nodes
                    287: **     (no anchor bits)
                    288: **
                    289: **  On exit,
                    290: **     The return result points to a newly allocated name which, if
                    291: **     parsed by HTParse relative to relatedName, will yield aName.
                    292: **     The caller is responsible for freeing the resulting name later.
                    293: **
                    294: */
                    295: #ifdef __STDC__
                    296: char * HTRelative(const char * aName, const char *relatedName)
                    297: #else
                    298: char * HTRelative(aName, relatedName)
                    299:    char * aName;
                    300:    char * relatedName;
                    301: #endif
                    302: {
                    303:     char * result = 0;
                    304:     CONST char *p = aName;
                    305:     CONST char *q = relatedName;
                    306:     CONST char * after_access = 0;
                    307:     CONST char * path = 0;
                    308:     CONST char * last_slash = 0;
                    309:     int slashes = 0;
                    310:     
                    311:     for(;*p; p++, q++) {       /* Find extent of match */
                    312:        if (*p!=*q) break;
                    313:        if (*p==':') after_access = p+1;
                    314:        if (*p=='/') {
                    315:            last_slash = p;
                    316:            slashes++;
                    317:            if (slashes==3) path=p;
                    318:        }
                    319:     }
                    320:     
                    321:     /* q, p point to the first non-matching character or zero */
                    322:     
                    323:     if (!after_access) {                       /* Different access */
                    324:         StrAllocCopy(result, aName);
                    325:     } else if (slashes<3){                     /* Different nodes */
                    326:        StrAllocCopy(result, after_access);
                    327:     } else if (slashes==3){                    /* Same node, different path */
                    328:         StrAllocCopy(result, path);
                    329:     } else {                                   /* Some path in common */
                    330:         int levels= 0;
                    331:         for(; *q && (*q!='#'); q++)  if (*q=='/') levels++;
                    332:        result = (char *)malloc(3*levels + strlen(last_slash) + 1);
                    333:       if (result == NULL) outofmem(__FILE__, "HTRelative");
                    334:        result[0]=0;
                    335:        for(;levels; levels--)strcat(result, "../");
                    336:        strcat(result, last_slash+1);
                    337:     }
                    338:     if (TRACE) fprintf(stderr, "HT: `%s' expressed relative to\n    `%s' is\n   `%s'.",
                    339:                aName, relatedName, result);
                    340:     return result;
                    341: }

Webmaster