aboutsummaryrefslogtreecommitdiff
path: root/doc/microhttpd.texi
diff options
context:
space:
mode:
Diffstat (limited to 'doc/microhttpd.texi')
-rw-r--r--doc/microhttpd.texi13
1 files changed, 11 insertions, 2 deletions
diff --git a/doc/microhttpd.texi b/doc/microhttpd.texi
index 66b728aa..63aca697 100644
--- a/doc/microhttpd.texi
+++ b/doc/microhttpd.texi
@@ -1128,7 +1128,7 @@ right now).
1128 1128
1129 1129
1130@deftypefun int MHD_get_connection_values (struct MHD_Connection *connection, enum MHD_ValueKind kind, MHD_KeyValueIterator iterator, void *iterator_cls) 1130@deftypefun int MHD_get_connection_values (struct MHD_Connection *connection, enum MHD_ValueKind kind, MHD_KeyValueIterator iterator, void *iterator_cls)
1131Get all the headers matching @var{kind} from the request. 1131Get all the headers matching @var{kind} from the request.
1132 1132
1133The @var{iterator} callback is invoked once for each header, with 1133The @var{iterator} callback is invoked once for each header, with
1134@var{iterator_cls} as first argument. Return the number of entries 1134@var{iterator_cls} as first argument. Return the number of entries
@@ -1137,13 +1137,22 @@ iterating, @var{iterator} returns @code{MHD_NO}.
1137 1137
1138@var{iterator} can be @mynull{}: in this case this function just counts 1138@var{iterator} can be @mynull{}: in this case this function just counts
1139and returns the number of headers. 1139and returns the number of headers.
1140
1141In the case of @code{MHD_GET_ARGUMENT_KIND}, the @var{value} argument
1142will be NULL if the URL contained a key without an equals operator.
1143For example, for a HTTP request to the URL ``http://foo/bar?key'', the
1144@var{value} argument is NULL; in contrast, a HTTP request to the URL
1145``http://foo/bar?key='', the @var{value} argument is the empty string.
1146The normal case is that the URL contains ``http://foo/bar?key=value''
1147in which case @var{value} would be the string ``value'' and @var{key}
1148would contain the string ``key''.
1140@end deftypefun 1149@end deftypefun
1141 1150
1142 1151
1143@deftypefun int MHD_set_connection_value (struct MHD_Connection *connection, enum MHD_ValueKind kind, const char * key, const char * value) 1152@deftypefun int MHD_set_connection_value (struct MHD_Connection *connection, enum MHD_ValueKind kind, const char * key, const char * value)
1144This function can be used to add an entry to 1153This function can be used to add an entry to
1145the HTTP headers of a connection (so that the 1154the HTTP headers of a connection (so that the
1146MHD_get_connection_values function will return 1155@code{MHD_get_connection_values function} will return
1147them -- and the MHD PostProcessor will also 1156them -- and the MHD PostProcessor will also
1148see them). This maybe required in certain 1157see them). This maybe required in certain
1149situations (see Mantis #1399) where (broken) 1158situations (see Mantis #1399) where (broken)