diff options
Diffstat (limited to 'doc/libmicrohttpd.texi')
-rw-r--r-- | doc/libmicrohttpd.texi | 13 |
1 files changed, 12 insertions, 1 deletions
diff --git a/doc/libmicrohttpd.texi b/doc/libmicrohttpd.texi index f2e3576c..97a79bdc 100644 --- a/doc/libmicrohttpd.texi +++ b/doc/libmicrohttpd.texi | |||
@@ -1356,7 +1356,7 @@ reason for request termination see @code{MHD_OPTION_NOTIFY_COMPLETED}. | |||
1356 | @end deftypefn | 1356 | @end deftypefn |
1357 | 1357 | ||
1358 | 1358 | ||
1359 | @deftypefn {Function Pointer} int {*MHD_KeyValueIterator} (void *cls, enum MHD_ValueKind kind, const char *key, const char *value) | 1359 | @deftypefn {Function Pointer} int {*MHD_KeyValueIterator} (void *cls, enum MHD_ValueKind kind, const char *key, const char *value, size_t value_size) |
1360 | Iterator over key-value pairs. This iterator can be used to iterate | 1360 | Iterator over key-value pairs. This iterator can be used to iterate |
1361 | over all of the cookies, headers, or @code{POST}-data fields of a | 1361 | over all of the cookies, headers, or @code{POST}-data fields of a |
1362 | request, and also to iterate over the headers that have been added to a | 1362 | request, and also to iterate over the headers that have been added to a |
@@ -1375,6 +1375,17 @@ key for the value, can be an empty string | |||
1375 | @item value | 1375 | @item value |
1376 | value corresponding value, can be NULL | 1376 | value corresponding value, can be NULL |
1377 | 1377 | ||
1378 | @item value_size | ||
1379 | number of bytes in @code{value}. This argument was introduced in | ||
1380 | @code{MHD_VERSION} 0x00096301 to allow applications to use binary | ||
1381 | zeros in values. Applications using this argument must ensure that | ||
1382 | they are using a sufficiently recent version of MHD, i.e. by testing | ||
1383 | @code{MHD_get_version()} for values above or equal to 0.9.64. | ||
1384 | Applications that do not need zeros in values and that want to compile | ||
1385 | without warnings against newer versions of MHD should not declare this | ||
1386 | argument and cast the function pointer argument to | ||
1387 | @code{MHD_KeyValueIterator}. | ||
1388 | |||
1378 | @end table | 1389 | @end table |
1379 | 1390 | ||
1380 | Return @code{MHD_YES} to continue iterating, @code{MHD_NO} to abort the | 1391 | Return @code{MHD_YES} to continue iterating, @code{MHD_NO} to abort the |