Function esp_idf_sys::httpd_query_key_value
source · pub unsafe extern "C" fn httpd_query_key_value(
qry: *const c_char,
key: *const c_char,
val: *mut c_char,
val_size: usize,
) -> esp_err_t
Expand description
@brief Helper function to get a URL query tag from a query string of the type param1=val1¶m2=val2
@note
- The components of URL query string (keys and values) are not URLdecoded. The user must check for ‘Content-Type’ field in the request headers and then depending upon the specified encoding (URLencoded or otherwise) apply the appropriate decoding algorithm.
- If actual value size is greater than val_size, then the value is truncated, accompanied by truncation error as return value.
@param[in] qry Pointer to query string @param[in] key The key to be searched in the query string @param[out] val Pointer to the buffer into which the value will be copied if the key is found @param[in] val_size Size of the user buffer “val”
@return
- ESP_OK : Key is found in the URL query string and copied to buffer
- ESP_ERR_NOT_FOUND : Key not found
- ESP_ERR_INVALID_ARG : Null arguments
- ESP_ERR_HTTPD_RESULT_TRUNC : Value string truncated