Abort Controller

Functions for request cancellation. More...

Functions
fetch_abort_controller_t *	fetch_abort_controller_new (void)
	Create a new abort controller.
void	fetch_abort_controller_abort (fetch_abort_controller_t *controller, const char *reason)
	Abort operations using this controller.
bool	fetch_abort_controller_aborted (const fetch_abort_controller_t *controller)
	Check if controller has been aborted.
void	fetch_abort_controller_free (fetch_abort_controller_t *controller)
	Free an abort controller.

Detailed Description

Functions for request cancellation.

Function Documentation

fetch_abort_controller_abort()

void fetch_abort_controller_abort	(	fetch_abort_controller_t *	controller,
		const char *	reason )

Abort operations using this controller.

Parameters

controller	The abort controller
reason	Optional reason for abortion

fetch_abort_controller_aborted()

bool fetch_abort_controller_aborted

(

const fetch_abort_controller_t *

controller

)

Check if controller has been aborted.

Parameters

controller

The abort controller

Returns

true if aborted

fetch_abort_controller_free()

void fetch_abort_controller_free

(

fetch_abort_controller_t *

controller

)

Free an abort controller.

Parameters

controller

Controller to free (can be NULL)

Note

Memory: Frees the controller

fetch_abort_controller_new()

fetch_abort_controller_t * fetch_abort_controller_new

(

void

)

Create a new abort controller.

Returns

New abort controller (caller owns, must call fetch_abort_controller_free() if not passed to fetch_init), or NULL on failure

Note

Memory: Returns owned object that must be freed

fetch_abort_controller_t *controller = fetch_abort_controller_new();
if (!controller) {
    fprintf(stderr, "Failed to create abort controller\n");
    return -1;
}
 
fetch_init_t *init = fetch_init_new();
fetch_init_signal(init, controller); // Controller is borrowed by init
 
fetch_promise_t *promise = fetch_async("https://httpbin.org/delay/10", init);
 
// Cancel after 5 seconds
sleep(5);
fetch_abort_controller_abort(controller, "Took too long");
 
// Cleanup (order matters)
fetch_promise_free(promise);
fetch_init_free(init); // This frees the controller