1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
|
/*
* Modification History
*
* 2002-May-10 Jason Rohrer
* Created.
*
* 2002-May-11 Jason Rohrer
* Added functions for hex encoding and decoding.
*
* 2002-October-8 Jason Rohrer
* Added functions for extracting query arguments.
*/
#include "minorGems/common.h"
#ifndef URL_UTILS_INCLUDED
#define URL_UTILS_INCLUDED
/**
* Utilities for handling URLS.
*
* @author Jason Rohrer
*/
class URLUtils {
public:
/**
* Gets the root server from a URL.
*
* For example, if the URL is http://www.yahoo.com/test.html
* the root server is www.yahoo.com
*
* @param inURL the URL as a \0-terminated string.
* Must be destroyed by caller if non-const.
*
* @return the root server as a newly allocated
* \0-terminated string.
* Must be destroyed by caller.
*/
static char *getRootServer( char *inURL );
/**
* Gets the root-relative path from a URL.
*
* For example, if the URL is http://www.yahoo.com/temp/test/test.html
* the root-relative path is /temp/test/
*
* @param inURL the URL as a \0-terminated string.
* Must be destroyed by caller if non-const.
*
* @return the root-relative path as a newly allocated
* \0-terminated string.
* Must be destroyed by caller.
*/
static char *getRootRelativePath( char *inURL );
/**
* Removes explicit hex encoding from a string.
*
* For example
* http%3A%2F%2Fservera.com%2Ftesta.html
* would be converted to
* http://servera.com/testa.html
*
* @param inString the string to convert in \0-terminated form.
* Must be destroyed by caller if non-const.
*
* @return a newly allocated converted string in \0-terminated form.
* Must be destroyed by caller.
*/
static char *hexDecode( char *inString );
/**
* Encodes a string in a browser-safe hex encoding
* (including adding '+' for each space).
*
* @param inString the string to encode.
* Must be destroyed by caller.
*
* @return an encoded string. Must be destroyed by caller.
*/
static char *hexEncode( char *inString );
/**
* Extracts the value from an argument of the form:
* name=value& or
* name=value[string_end]
*
* Note that if name is the suffix of an argument with a longer name
* the longer-named argument's value may be returned. Thus,
* argument names should not be suffixes of eachother.
*
* All parameters must be destroyed by caller.
*
* @param inHaystack the string to extract the argument from.
* @param inArgName the argument name (without ?, &, or =) to search
* for in inHaystack.
*
* @return the value of the argument, or NULL if the argument is
* not found. Must be destroyed by caller if non-NULL.
*/
static char *extractArgument( char *inHaystack,
char *inArgName );
/**
* The same as extractArgument, except that explicit
* hex representations are translated to plain ascii
* before the argument value is returned.
*/
static char *extractArgumentRemoveHex( char *inHaystack,
char *inArgName );
};
#endif
|
