1 #ifndef LIB_URL_H

     2 #define LIB_URL_H

     3 

     4 /*

     5  * A trivial parser for simple URLs

     6  *

     7  * [ <scheme> [ "+" <scheme> [ ... ] ] "://" ] [ <username> [ ":" <password> ] "@" ] <hostname> [ ":" <service> ] [ "/" <path> ] [ "?" [ <key> [ "=" <value> ] ] [ "&" [ <key> [ "="     <value> ] ] [ ... ] ]

     8  *

     9  *  example.com

    10  *  tcp://example.com:7348/

    11  *  psql://postgres@localhost/test_db?charset=utf8

    12  *  

    13  */

    14 

    15 /*

    16  * The schema

    17  */

    18 struct url_schema {

    19     size_t count;

    20     const char **list;

    21 };

    22 

    23 /*

    24  * The options at the end

    25  */

    26 struct url_opts {

    27     size_t count;

    28     struct url_opt {

    29         const char *key;

    30         const char *value;

    31     } *list;

    32 };

    33 

    34 /*

    35  * A parsed URL

    36  */

    37 struct url {

    38     struct url_schema *schema;

    39     const char *username;

    40     const char *password;

    41     const char *hostname;

    42     const char *service;

    43     const char *path;

    44     struct url_opts *opts;

    45 };

    46 

    47 /*

    48  * Parse the given `text` as an URL, returning the result in `url`. Optional fields that are missing in the text will

    49  * cause those values to be returned unmodified.

    50  */

    51 int url_parse (struct url *url, const char *text);

    52 

    53 #endif /* LIB_URL_H */