XtNextEvent(3)

💖 XtNextEvent — the girlies' guide to querying and processing events 💖

okay so bestie, welcome to the XtNextEvent manual page, straight out of the XT COMPATIBILITY FUNCTIONS section of libXt. these are the legacy girls — the originals — and they're all about querying and processing events and input. 🦋

---

✨ NAME ✨

XtNextEvent, XtPending, XtPeekEvent, XtProcessEvent, XtMainLoop — query and process events and input, no cap. 👑

---

✨ SYNTAX ✨

first thing you do, always: pull in the header. iconic behavior.

#include <X11/Intrinsic.h>

then the five function signatures, verbatim, don't @ me:

void XtNextEvent(XEvent *event_return);

Boolean XtPeekEvent(XEvent *event_return);

Boolean XtPending(void);

void XtProcessEvent(XtInputMask mask);

void XtMainLoop(void);

---

✨ ARGUMENTS ✨

• event — this one's a pointer to the event structure that's gonna get dispatched to the appropriate event handler. it's giving "hand off the mail to the right mailbox". 📬
• event_return — the event info comes back to you in this event structure you specified. it literally returns the event information there. 💌
• mask — this tells you what types of events to process. it's the bitwise inclusive OR of any combination of XtIMXEvent, XtIMTimer, XtIMAlternateInput, and XtIMSignal. and as a lil convenience, the X Toolkit defines the symbolic name XtIMAll to be the bitwise inclusive OR of all event types. so like, XtIMAll = all of them, periodt. 🌈

---

✨ DESCRIPTION ✨

okay so here's the tea, and it's a little sad but we move: every single one of these has been replaced. 😭

• XtNextEvent has been replaced by XtAppNextEvent.
• XtPeekEvent has been replaced by XtAppPeekEvent.
• XtPending has been replaced by XtAppPending.
• XtProcessEvent has been replaced by XtAppProcessEvent.
• XtMainLoop has been replaced by XtAppMainLoop.

like, they're still here, they still work, but the glow-up versions exist and you should lowkey be using those. this is the compatibility corner of the library, bestie. 💅

---

✨ SEE ALSO ✨

go read these next, fr fr:

• XtAppNextEvent(3xt)
• XtAppPending(3)
• XtAppPeekEvent(3)
• XtAppProcessEvent(3)
• XtAppMainLoop(3)
• X Toolkit Intrinsics - C Language Interface
• Xlib - C Language X Interface

---

and that's the whole page, bestie. short, sweet, and entirely made of "use the App version instead". 💀

---

mwah 💋 this page came to you from X Version 11, libXt 1.3.1 — so like, this is the libXt girlies' era, not the Xlib one. take care of her, she's vintage. 🎀