uri.h (4256B)
1/** 2 * Summary: library of generic URI related routines 3 * Description: library of generic URI related routines 4 * Implements RFC 2396 5 * 6 * Copyright (C) 1998-2003 Daniel Veillard. All Rights Reserved. 7 * 8 * Permission is hereby granted, free of charge, to any person obtaining a copy 9 * of this software and associated documentation files (the "Software"), to deal 10 * in the Software without restriction, including without limitation the rights 11 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 12 * copies of the Software, and to permit persons to whom the Software is 13 * furnished to do so, subject to the following conditions: 14 * 15 * The above copyright notice and this permission notice shall be included in 16 * all copies or substantial portions of the Software. 17 * 18 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 19 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 20 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE 21 * DANIEL VEILLARD BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER 22 * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN 23 * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. 24 * 25 * Except as contained in this notice, the name of Daniel Veillard shall not 26 * be used in advertising or otherwise to promote the sale, use or other 27 * dealings in this Software without prior written authorization from him. 28 * 29 * Author: Daniel Veillard 30 ** 31 * Copyright (C) 2007 Red Hat, Inc. 32 * 33 * This library is free software; you can redistribute it and/or 34 * modify it under the terms of the GNU Lesser General Public 35 * License as published by the Free Software Foundation; either 36 * version 2.1 of the License, or (at your option) any later version. 37 * 38 * This library is distributed in the hope that it will be useful, 39 * but WITHOUT ANY WARRANTY; without even the implied warranty of 40 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 41 * Lesser General Public License for more details. 42 * 43 * You should have received a copy of the GNU Lesser General Public 44 * License along with this library; if not, write to the Free Software 45 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA 46 * 47 * Authors: 48 * Richard W.M. Jones <rjones@redhat.com> 49 * 50 * Utility functions to help parse and assemble query strings. 51 */ 52 53#ifndef QEMU_URI_H 54#define QEMU_URI_H 55 56#ifdef __cplusplus 57extern "C" { 58#endif 59 60/** 61 * URI: 62 * 63 * A parsed URI reference. This is a struct containing the various fields 64 * as described in RFC 2396 but separated for further processing. 65 */ 66typedef struct URI { 67 char *scheme; /* the URI scheme */ 68 char *opaque; /* opaque part */ 69 char *authority; /* the authority part */ 70 char *server; /* the server part */ 71 char *user; /* the user part */ 72 int port; /* the port number */ 73 char *path; /* the path string */ 74 char *fragment; /* the fragment identifier */ 75 int cleanup; /* parsing potentially unclean URI */ 76 char *query; /* the query string (as it appears in the URI) */ 77} URI; 78 79URI *uri_new(void); 80char *uri_resolve(const char *URI, const char *base); 81char *uri_resolve_relative(const char *URI, const char *base); 82URI *uri_parse(const char *str); 83URI *uri_parse_raw(const char *str, int raw); 84int uri_parse_into(URI *uri, const char *str); 85char *uri_to_string(URI *uri); 86char *uri_string_escape(const char *str, const char *list); 87char *uri_string_unescape(const char *str, int len, char *target); 88void uri_free(URI *uri); 89 90/* Single web service query parameter 'name=value'. */ 91typedef struct QueryParam { 92 char *name; /* Name (unescaped). */ 93 char *value; /* Value (unescaped). */ 94 int ignore; /* Ignore this field in qparam_get_query */ 95} QueryParam; 96 97/* Set of parameters. */ 98typedef struct QueryParams { 99 int n; /* number of parameters used */ 100 int alloc; /* allocated space */ 101 QueryParam *p; /* array of parameters */ 102} QueryParams; 103 104struct QueryParams *query_params_new (int init_alloc); 105extern QueryParams *query_params_parse (const char *query); 106extern void query_params_free (QueryParams *ps); 107 108#ifdef __cplusplus 109} 110#endif 111#endif /* QEMU_URI_H */