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

# XmFontListGetNextFont(3)

A font list function that allows applications to access the fonts and character sets in a font list

## NAME

**XmFontListGetNextFont** — A font list function that allows applications to access the fonts and character sets in a font list

## SYNOPSIS

```
#include <Xm/Xm.h>
Boolean XmFontListGetNextFont(
XmFontContext context,
XmStringCharSet *charset,
XFontStruct **font);
```

## DESCRIPTION

**XmFontListGetNextFont** accesses the character set and font for the next entry of the font list. The application first uses the **XmFontListInitFontContext** routine to create a font list context. The application then calls **XmFontListGetNextFont** repeatedly with the same context. Each succeeding call accesses the next element of the font list. When finished, the application calls **XmFontListFreeFontContext** to free the allocated font list context.

This routine allocates memory for the character set string that must be freed by the application. The function allocates memory for *charset*. The application is responsible for managing the allocated memory. The application can recover the allocated memory by calling **XtFree**.

This function is obsolete and exists for compatibility with previous releases. It is replaced by **XmFontListNextEntry**. If **XmFontListGetNextFont** is passed a context that contains a font set entry, it will return the first font of the font set. The next call to the function will move to the next entry in the font list.

- *context*

  Specifies the font list context

- *charset*

  Specifies a pointer to a character set string; the routine returns the character set for the current font list element

- *font*

  Specifies a pointer to a pointer to a font structure; the routine returns the font for the current font list element

## RETURN

Returns True if the returned values are valid; otherwise, returns False.

## RELATED

[**XmFontList**(3)](/XmFontList/3.md) and [**XmFontListNextEntry**(3)](/XmFontListNextEntry/3.md).