QB_LOOP_JOB_DEL(3)

💖 QB_LOOP_JOB_DEL 💖

okay bestie, so we're deep in the libqb programmer's manual rn, and this one is qb_loop_job_del(3) — yes, the mainloop girlies' fave. buckle up 🎀

---

✨ NAME ✨

qb_loop_job_del — Delete a job from the mainloop. bye bestie, you're cancelled 💅

---

🌸 SYNOPSIS 🌸

#include <qb/qbloop.h>

int32_t qb_loop_job_del(
    struct qb_loop          *l,            /* pointer to the loop instance */
    enum qb_loop_priority    p,            /* the priority */
    void                    *data,         /* user data passed into the dispatch function */
    qb_loop_job_dispatch_fn  dispatch_fn   /* callback function */
);

look at her. four little args. so demure, so mindful. 🦋

---

🫶 PARAMS 🫶

• l — pointer to the loop instance. like, the actual mainloop you're messing with.
• p — the priority. lowkey important, we'll get to that.
• data — user data passed into the dispatch function. your little payload, your little vibe carrier.
• dispatch_fn — callback function. the thing that would've run, if it hadn't been so brutally deleted 💀

---

💅 DESCRIPTION 💅

This will try to delete the job — but only if it hasn't run yet. so if it already ran? too late babe, it's gone, nothing to delete. the way that this function is literally just "if you're not early, you're late" 😭

---

🏗️ STRUCTURES 🏗️

here's the priority enum, and yes she's giving iconic:

enum qb_loop_priority {
      QB_LOOP_LOW;
      QB_LOOP_MED;
      QB_LOOP_HIGH;
};

QB_LOOP_LOW, QB_LOOP_MED, QB_LOOP_HIGH — pick your fighter ✨

---

⭐ RETURN VALUE ⭐

status (0 == ok, -errno == failure)

so like, 0 means slay, -errno means it's giving tragedy 🙈

---

👑 NOTE 👑

this will remove the first job that matches the parameters (priority, data, dispatch_fn).

not the second one. not all of them. the first one. periodt.

---

🌈 SEE ALSO 🌈

the whole friend group, fr fr:

• qb_loop_run(3)
• qb_loop_create(3)
• qb_loop_stop(3)
• qb_loop_poll_low_fds_event_set(3)
• qb_loop_signal_del(3)
• qb_loop_signal_add(3)
• qb_loop_job_add(3)
• qb_loop_poll_del(3)
• qb_loop_destroy(3)
• qb_loop_timer_expire_time_remaining(3)
• qb_loop_poll_mod(3)
• qb_loop_signal_mod(3)
• qb_loop_timer_del(3)
• qb_loop_timer_add(3)
• qb_loop_timer_is_running(3)
• qb_loop_timer_expire_time_get(3)
• qb_loop_poll_add(3)

---

📜 COPYRIGHT 📜

Copyright (C) 2010-2020 Red Hat, Inc.

---

and that's the whole page bestie!! this lil masterpiece lives in the libqb manual, dated 2025-09-16, brought to you by LIBQB — and it's called QB_LOOP_JOB_DEL(3) in case the header up top didn't already give that away 💖✨🎀 ily, go delete some jobs (respectfully) 🦋💅