GNUnet 0.21.1
gnunet_uri_lib.h File Reference
This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures

struct  GNUNET_Uri
 Copyright (C) 2016 Jack Engqvist Johansson. More...
 
struct  GNUNET_UriParam
 

Functions

int GNUNET_uri_parse (struct GNUNET_Uri *url, char *url_str)
 Parse a URL to a struct. More...
 
int GNUNET_uri_split_path (char *path, char **parts, int max_parts)
 Split a path into several strings. More...
 
int GNUNET_uri_parse_query (char *query, char delimiter, struct GNUNET_UriParam *params, int max_params)
 Parse a query string into a key/value struct. More...
 

Function Documentation

◆ GNUNET_uri_parse()

int GNUNET_uri_parse ( struct GNUNET_Uri url,
char *  u 
)

Parse a URL to a struct.

The URL string should be in one of the following formats:

Absolute URL: scheme ":" [ "//" ] [ username ":" password "@" ] host [ ":" port ] [ "/" ] [ path ] [ "?" query ] [ "#" fragment ]

Relative URL: path [ "?" query ] [ "#" fragment ]

The following parts will be parsed to the corresponding struct member.

*url: a pointer to the struct where to store the parsed values. *url_str: a pointer to the url to be parsed (null terminated). The string will be modified.

Returns 0 on success, otherwise -1.

Definition at line 160 of file uri.c.

162{
163 if (NULL == url || NULL == u) {
164 return -1;
165 }
166
167 memset(url, 0, sizeof (struct GNUNET_Uri));
168
169 /* (Fragment) */
170 url->fragment = find_fragment (u);
171
172 /* (Query) */
173 url->query = find_query (u);
174
175 /* Relative URL? Parse scheme and hostname */
176 if (!is_relative (u)) {
177 /* Scheme */
178 url->scheme = u;
179 u = parse_scheme (u);
180 if (u == NULL) {
181 return -1;
182 }
183
184 /* Host */
185 if ('\0' == *u) {
186 return -1;
187 }
188 url->host = u;
189
190 /* (Path) */
191 url->path = find_path (u);
192
193 /* (Credentials) */
194 u = strchr (url->host, '@');
195 if (NULL != u) {
196 /* Missing credentials? */
197 if (u == url->host) {
198 return -1;
199 }
200
201 url->username = url->host;
202 url->host = u + 1;
203 *u = '\0';
204
205 u = strchr (url->username, ':');
206 if (NULL == u) {
207 return -1;
208 }
209
210 url->password = u + 1;
211 *u = '\0';
212 }
213
214 /* Missing hostname? */
215 if ('\0' == *url->host) {
216 return -1;
217 }
218
219 /* (Port) */
220 u = strchr (url->host, ':');
221 if (NULL != u && (NULL == url->path || u < url->path)) {
222 *(u++) = '\0';
223 if ('\0' == *u) {
224 return -1;
225 }
226
227 if (url->path) {
228 url->port = natoi (u, url->path - u - 1);
229 } else {
230 url->port = atoi (u);
231 }
232 }
233
234 /* Missing hostname? */
235 if ('\0' == *url->host) {
236 return -1;
237 }
238 } else {
239 /* (Path) */
240 url->path = find_path (u);
241 }
242
243 return 0;
244}
static mp_limb_t u[(((256)+GMP_NUMB_BITS - 1)/GMP_NUMB_BITS)]
Copyright (C) 2016 Jack Engqvist Johansson.
char * scheme
char * username
char * query
char * password
char * fragment
static char * find_fragment(char *str)
Definition: uri.c:120
static int is_relative(const char *url)
Check if a URL is relative (no scheme and hostname).
Definition: uri.c:57
static char * find_query(char *str)
Definition: uri.c:127
static int natoi(const char *str, size_t len)
Copyright (C) 2016,2017 Jack Engqvist Johansson.
Definition: uri.c:36
static char * find_path(char *str)
Definition: uri.c:134
static char * parse_scheme(char *str)
Parse the scheme of a URL by inserting a null terminator after the scheme.
Definition: uri.c:71

References find_fragment(), find_path(), find_query(), GNUNET_Uri::fragment, GNUNET_Uri::host, is_relative(), natoi(), parse_scheme(), GNUNET_Uri::password, GNUNET_Uri::path, GNUNET_Uri::port, GNUNET_Uri::query, GNUNET_Uri::scheme, u, and GNUNET_Uri::username.

Here is the call graph for this function:

◆ GNUNET_uri_split_path()

int GNUNET_uri_split_path ( char *  path,
char **  parts,
int  max_parts 
)

Split a path into several strings.

No data is copied, the slashed are used as null terminators and then pointers to each path part will be stored in **parts. Double slashes will be treated as one.

*path: the path to split. The string will be modified. **parts: a pointer to an array of (char *) where to store the result. max_parts: max number of parts to parse.

Returns the number of parsed items. -1 on error.

Definition at line 261 of file uri.c.

264{
265 int i = 0;
266
267 if (NULL == path || '\0' == *path) {
268 return -1;
269 }
270
271 do {
272 /* Forward to after slashes */
273 while (*path == '/') path++;
274
275 if ('\0' == *path) {
276 break;
277 }
278
279 parts[i++] = path;
280
281 path = strchr (path, '/');
282 if (NULL == path) {
283 break;
284 }
285
286 *(path++) = '\0';
287 } while (i < max_parts);
288
289 return i;
290}

◆ GNUNET_uri_parse_query()

int GNUNET_uri_parse_query ( char *  query,
char  delimiter,
struct GNUNET_UriParam params,
int  max_params 
)

Parse a query string into a key/value struct.

The query string should be a null terminated string of parameters separated by a delimiter. Each parameter are checked for the equal sign character. If it appears in the parameter, it will be used as a null terminator and the part that comes after it will be the value of the parameter.

No data are copied, the equal sign and delimiters are used as null terminators and then pointers to each parameter key and value will be stored in the yuarel_param struct.

*query: the query string to parse. The string will be modified. delimiter: the character that separates the key/value pairs from each other. *params: an array of (struct yuarel_param) where to store the result. max_values: max number of parameters to parse.

Returns the number of parsed items. -1 on error.

Definition at line 313 of file uri.c.

317{
318 int i = 0;
319
320 if (NULL == query || '\0' == *query) {
321 return -1;
322 }
323
324 params[i++].key = query;
325 while (i < max_params && NULL != (query = strchr (query, delimiter))) {
326 *query = '\0';
327 params[i].key = ++query;
328 params[i].val = NULL;
329
330 /* Go back and split previous param */
331 if (i > 0) {
332 if ((params[i - 1].val = strchr (params[i - 1].key, '=')) != NULL) {
333 *(params[i - 1].val)++ = '\0';
334 }
335 }
336 i++;
337 }
338
339 /* Go back and split last param */
340 if ((params[i - 1].val = strchr (params[i - 1].key, '=')) != NULL) {
341 *(params[i - 1].val)++ = '\0';
342 }
343
344 return i;
345}
struct GNUNET_HashCode key
The key used in the DHT.

References key, GNUNET_UriParam::key, and GNUNET_UriParam::val.