diff options
Diffstat (limited to 'doc/microhttpd.texi')
-rw-r--r-- | doc/microhttpd.texi | 13 |
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) |
1131 | Get all the headers matching @var{kind} from the request. | 1131 | Get all the headers matching @var{kind} from the request. |
1132 | 1132 | ||
1133 | The @var{iterator} callback is invoked once for each header, with | 1133 | The @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 |
1139 | and returns the number of headers. | 1139 | and returns the number of headers. |
1140 | |||
1141 | In the case of @code{MHD_GET_ARGUMENT_KIND}, the @var{value} argument | ||
1142 | will be NULL if the URL contained a key without an equals operator. | ||
1143 | For 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. | ||
1146 | The normal case is that the URL contains ``http://foo/bar?key=value'' | ||
1147 | in which case @var{value} would be the string ``value'' and @var{key} | ||
1148 | would 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) |
1144 | This function can be used to add an entry to | 1153 | This function can be used to add an entry to |
1145 | the HTTP headers of a connection (so that the | 1154 | the HTTP headers of a connection (so that the |
1146 | MHD_get_connection_values function will return | 1155 | @code{MHD_get_connection_values function} will return |
1147 | them -- and the MHD PostProcessor will also | 1156 | them -- and the MHD PostProcessor will also |
1148 | see them). This maybe required in certain | 1157 | see them). This maybe required in certain |
1149 | situations (see Mantis #1399) where (broken) | 1158 | situations (see Mantis #1399) where (broken) |