---
name: "XtNextEvent"
section: "3"
platform: "linux"
package: "libxt"
version: "1.3.1-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/XtNextEvent"
---

# XtNextEvent(3)

query and process events and input

## NAME

XtNextEvent, XtPending, XtPeekEvent, XtProcessEvent, XtMainLoop - query and process events and input

## SYNTAX

\#include \<X11/Intrinsic.h\>

void XtNextEvent(XEvent \**event\_return*);

Boolean XtPeekEvent(XEvent \**event\_return*);

Boolean XtPending(void);

void XtProcessEvent(XtInputMask *mask*);

void XtMainLoop(void);

## ARGUMENTS

- *event*

  Specifies a pointer to the event structure that is to be dispatched to the appropriate event handler.

- *event\_return*

  Returns the event information to the specified event structure.

- *mask*

  Specifies what types of events to process. The mask is the bitwise inclusive OR of any combination of **XtIMXEvent**, **XtIMTimer**, **XtIMAlternateInput**, and **XtIMSignal**. As a convenience, the X Toolkit defines the symbolic name **XtIMAll** to be the bitwise inclusive OR of all event types.

## DESCRIPTION

**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**.

## SEE ALSO

XtAppNextEvent(3xt), [XtAppPending(3)](/XtAppPending/3.md), [XtAppPeekEvent(3)](/XtAppPeekEvent/3.md), [XtAppProcessEvent(3)](/XtAppProcessEvent/3.md), [XtAppMainLoop(3)](/XtAppMainLoop/3.md)\
 *X Toolkit Intrinsics - C Language Interface*\
 *Xlib - C Language X Interface*