esp_http_server : Minor clarification in httpd_req_get_url_query_str() API documentation

Closes https://github.com/espressif/esp-idf/issues/3374
This commit is contained in:
Anurag Kar 2019-05-06 14:32:24 +05:30 committed by bot
parent a298d32d65
commit d0e7fd4369

View file

@ -870,7 +870,10 @@ size_t httpd_req_get_url_query_len(httpd_req_t *r);
* a URI handler where httpd_req_t* request pointer is valid * a URI handler where httpd_req_t* request pointer is valid
* - If output size is greater than input, then the value is truncated, * - If output size is greater than input, then the value is truncated,
* accompanied by truncation error as return value * accompanied by truncation error as return value
* - Use httpd_req_get_url_query_len() to know the right buffer length * - Prior to calling this function, one can use httpd_req_get_url_query_len()
* to know the query string length beforehand and hence allocate the buffer
* of right size (usually query string length + 1 for null termination)
* for storing the query string
* *
* @param[in] r The request being responded to * @param[in] r The request being responded to
* @param[out] buf Pointer to the buffer into which the query string will be copied (if found) * @param[out] buf Pointer to the buffer into which the query string will be copied (if found)