assoc_array_insert(9)

💖 assoc_array_insert(9) — Kernel API Manual 💖

🌸 NAME 🌸

Script insertion of an object into an associative array. Bestie, that is literally the whole plot. ✨

🦋 SYNOPSIS 🦋

struct assoc_array_edit * assoc_array_insert (struct assoc_array *array
, const struct assoc_array_ops *ops , const void *index_key , void
*object );

🎀 ARGUMENTS 🎀

• array — the array to insert into, bestie.
• ops — the operations to use.
• index_key — the key to insert at.
• object — the object to insert.

✨ DESCRIPTION ✨

Okay so this function precalculates and preallocates a script for inserting or replacing an object in an associative array. The result is an edit script that can either be applied or cancelled. 💅

The function returns a pointer to an edit script or -ENOMEM. No cap. 💖

The caller should lock against other modifications, and must continue to hold that lock until assoc_array_apply_edit has been called. Like, do not let go early — the lock stays held until that call happens. 🔒

Accesses to the tree may take place concurrently with this function, provided they hold the RCU read lock. 🦋

👑 SEE ALSO 👑

• Kernel file ./lib/assoc_array.c
• assoc_array_iterate(9)
• assoc_array_find(9)
• assoc_array_destroy(9)
• assoc_array_insert_set_object(9)
• assoc_array_delete(9)
• assoc_array_clear(9)
• assoc_array_apply_edit(9)
• assoc_array_cancel_edit(9)
• assoc_array_gc(9)

💌 source/version: ./lib · date: October 2026 · page: assoc_array_insert(9) — mwah! 💋