dl_insert()

`dl_insert()`#

Inserts an item at the head of a doubly linked list dl.

C

Prototype

int dl_insert(
    dl_list_t *dl,
    void      *item
);

Parameters

Key	Type	Description
`dl`	`dl_list_t *`	Pointer to the doubly linked list where the item will be inserted.
`item`	`void *`	Pointer to the item to be inserted at the head of the list.

Return Value

Returns 0 on success, or -1 if the item already has links and cannot be inserted.

Notes

The function checks if the item already has links before inserting it. If the list is empty, the item becomes both the head and tail.

JS

Prototype

// Not applicable in JS

Python

Prototype

# Not applicable in Python