Request Initialization

Functions for configuring requests. More...

Functions
fetch_init_t *	fetch_init_new (void)
	Create a new request configuration.
void	fetch_init_free (fetch_init_t *init)
	Free a request configuration.
fetch_init_t *	fetch_init_method (fetch_init_t *init, http_method_t method)
	Set HTTP method (fluent interface)
fetch_init_t *	fetch_init_headers (fetch_init_t *init, fetch_headers_t *headers)
	Set request headers (fluent interface)
fetch_init_t *	fetch_init_body (fetch_init_t *init, fetch_body_t *body)
	Set request body (fluent interface)
fetch_init_t *	fetch_init_timeout (fetch_init_t *init, uint32_t timeout_ms)
	Set request timeout (fluent interface)
fetch_init_t *	fetch_init_signal (fetch_init_t *init, fetch_abort_controller_t *signal)
	Set abort signal (fluent interface)

Detailed Description

Functions for configuring requests.

Function Documentation

fetch_init_body()

fetch_init_t * fetch_init_body	(	fetch_init_t *	init,
		fetch_body_t *	body )

Set request body (fluent interface)

Parameters

init	Init object
body	Body object (ownership transferred to init)

Returns

Same init object for chaining

Note

Memory: Ownership of body is transferred to init

fetch_init_free()

void fetch_init_free

(

fetch_init_t *

init

)

Free a request configuration.

Parameters

init	Init object to free (can be NULL)

Note

Memory: Frees the init object and all owned resources (headers, body, etc.)

fetch_init_headers()

fetch_init_t * fetch_init_headers	(	fetch_init_t *	init,
		fetch_headers_t *	headers )

Set request headers (fluent interface)

Parameters

init	Init object
headers	Headers object (ownership transferred to init)

Returns

Same init object for chaining

Note

Memory: Ownership of headers is transferred to init

fetch_init_method()

fetch_init_t * fetch_init_method	(	fetch_init_t *	init,
		http_method_t	method )

Set HTTP method (fluent interface)

Parameters

init	Init object
method	HTTP method

Returns

Same init object for chaining

fetch_init_new()

fetch_init_t * fetch_init_new

(

void

)

Create a new request configuration.

Returns

New init object with default values (caller owns, must call fetch_init_free()), or NULL on failure

Note

Memory: Returns owned object that must be freed

fetch_init_t *init = fetch_init_new();
if (!init) {
    fprintf(stderr, "Failed to create init\n");
    return -1;
}
 
// Configure request (these functions transfer ownership)
fetch_init_method(init, HTTP_METHOD_POST);
fetch_init_timeout(init, 10000); // 10 seconds
 
fetch_headers_t *headers = fetch_headers_new();
fetch_headers_set(headers, "Content-Type", "application/json");
fetch_init_headers(init, headers); // Ownership of headers transferred to
init
 
fetch_body_t *body = fetch_body_json("{\"test\": true}");
fetch_init_body(init, body); // Ownership of body transferred to init
 
// Use init with request...
 
fetch_init_free(init); // Required: frees init, headers, and body

fetch_init_signal()

fetch_init_t * fetch_init_signal	(	fetch_init_t *	init,
		fetch_abort_controller_t *	signal )

Set abort signal (fluent interface)

Parameters

init	Init object
signal	Abort controller (borrowed reference, init does not own)

Returns

Same init object for chaining

Note

Memory: Controller is borrowed, caller must keep it alive and free it

fetch_init_timeout()

fetch_init_t * fetch_init_timeout	(	fetch_init_t *	init,
		uint32_t	timeout_ms )

Set request timeout (fluent interface)

Parameters

init	Init object
timeout_ms	Timeout in milliseconds

Returns

Same init object for chaining