diff options
Diffstat (limited to 'src/util/url.c')
-rw-r--r-- | src/util/url.c | 17 |
1 files changed, 16 insertions, 1 deletions
diff --git a/src/util/url.c b/src/util/url.c index 22bdd3fc6..ec94f58b3 100644 --- a/src/util/url.c +++ b/src/util/url.c @@ -157,7 +157,10 @@ calculate_argument_length (va_list args) /** * Take the key-value pairs in @a args and serialize them into - * @a buf, using URL encoding for the values. + * @a buf, using URL encoding for the values. If a 'value' is + * given as NULL, both the key and the value are skipped. Note + * that a NULL value does not terminate the list, only a NULL + * key signals the end of the list of arguments. * * @param buf where to write the values * @param args NULL-terminated key-value pairs (char *) for query parameters, @@ -201,6 +204,10 @@ serialize_arguments (struct GNUNET_Buffer *buf, /** * Make an absolute URL with query parameters. * + * If a 'value' is given as NULL, both the key and the value are skipped. Note + * that a NULL value does not terminate the list, only a NULL key signals the + * end of the list of arguments. + * * @param base_url absolute base URL to use * @param path path of the url * @param ... NULL-terminated key-value pairs (char *) for query parameters, @@ -265,6 +272,10 @@ TALER_url_join (const char *base_url, /** * Make an absolute URL for the given parameters. * + * If a 'value' is given as NULL, both the key and the value are skipped. Note + * that a NULL value does not terminate the list, only a NULL key signals the + * end of the list of arguments. + * * @param proto protocol for the URL (typically https) * @param host hostname for the URL * @param prefix prefix for the URL @@ -308,6 +319,10 @@ TALER_url_absolute_raw_va (const char *proto, /** * Make an absolute URL for the given parameters. * + * If a 'value' is given as NULL, both the key and the value are skipped. Note + * that a NULL value does not terminate the list, only a NULL key signals the + * end of the list of arguments. + * * @param proto protocol for the URL (typically https) * @param host hostname for the URL * @param prefix prefix for the URL |