#include <xkbcommon.h>

Collaboration diagram for xkb_state_update:

Data Fields
size_t	size

const struct xkb_state_components_update *	components

const struct xkb_layout_policy_update *	layout_policy

Detailed Description

Request to process an out-of-band atomic update through an xkb_machine or xkb_state.

A NULL pointer means “not set / no change”.

Note

This struct uses a size-based versioning scheme to allow forward and backward compatibility between callers and the library:

Older callers (smaller struct): Trailing fields unknown to the caller default to zero in the library.
Newer callers (larger struct): Accepted only if all trailing bytes unknown to the library are zero.

Precondition: The struct MUST be initialized with memset() before setting any fields:
struct xkb_state_update update;

memset(&update, 0, sizeof(update));

update.size = sizeof(update);

update.components = …;

xkb_state_update
Request to process an out-of-band atomic update through an xkb_machine or xkb_state.
Definition xkbcommon.h:3681

Invariant: size MUST be explicitly set to sizeof(struct xkb_state_update).; All bytes of the struct, including padding, MUST remain zero except for explicitly assigned fields.