---
name: "XmFontListNextEntry"
section: "3"
platform: "linux"
package: "openmotif"
version: "2.3.8-4"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/XmFontListNextEntry"
---

# XmFontListNextEntry(3)

A font list function that returns the next entry in a font list

## NAME

**XmFontListNextEntry** — A font list function that returns the next entry in a font list

## SYNOPSIS

```
#include <Xm/Xm.h>
XmFontListEntry XmFontListNextEntry(
XmFontContext context);
```

## DESCRIPTION

**XmFontListNextEntry** returns the next entry in the font list. The application uses the **XmFontListInitFontContext** routine to create a font list context. The first call to **XmFontListNextEntry** sets the context to the first entry in the font list. The application then calls **XmFontListNextEntry** repeatedly with the same context. Each succeeding call accesses the next entry of the font list. When finished, the application calls **XmFontListFreeFontContext** to free the allocated font list context.

- *context*

  Specifies the font list context

## RETURN

Returns NULL if the context does not refer to a valid entry or if it is at the end of the font list; otherwise, it returns a font list entry. If the function does return a font list entry, the font list entry is not a copy. Therefore, the application should not free the returned font list entry.

## RELATED

[**XmFontList**(3)](/XmFontList/3.md), [**XmFontListEntryFree**(3)](/XmFontListEntryFree/3.md), [**XmFontListEntryGetFont**(3)](/XmFontListEntryGetFont/3.md), [**XmFontListEntryGetTag**(3)](/XmFontListEntryGetTag/3.md), [**XmFontListFreeFontContext**(3)](/XmFontListFreeFontContext/3.md), and [**XmFontListInitFontContext**(3)](/XmFontListInitFontContext/3.md).
