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

# XSaveContext(3)

associative look-up routines

## NAME

XSaveContext, XFindContext, XDeleteContext, XUniqueContext - associative look-up routines

## SYNTAX

int XSaveContext(Display \**display*, XID *rid*, XContext *context*, \_Xconst char \**data*);

int XFindContext(Display \**display*, XID *rid*, XContext *context*, XPointer \**data\_return*);

int XDeleteContext(Display \**display*, XID *rid*, XContext *context*);

XContext XUniqueContext(void);

## ARGUMENTS

- *context*

  Specifies the context type to which the data belongs.

- *data*

  Specifies the data to be associated with the window and type.

- *data\_return*

  Returns the data.

- *display*

  Specifies the connection to the X server.

- *rid*

  Specifies the resource ID with which the data is associated.

## DESCRIPTION

If an entry with the specified resource ID and type already exists, **XSaveContext** overrides it with the specified context. The **XSaveContext** function returns a nonzero error code if an error has occurred and zero otherwise. Possible errors are **XCNOMEM** (out of memory).

Because it is a return value, the data is a pointer. The **XFindContext** function returns a nonzero error code if an error has occurred and zero otherwise. Possible errors are **XCNOENT** (context-not-found).

The **XDeleteContext** function deletes the entry for the given resource ID and type from the data structure. This function returns the same error codes that **XFindContext** returns if called with the same arguments. **XDeleteContext** does not free the data whose address was saved.

The **XUniqueContext** function creates a unique context type that may be used in subsequent calls to **XSaveContext**.

## SEE ALSO

*Xlib - C Language X Interface*