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

# XmFontListCreate(3)

A font list function that creates a font list

## NAME

**XmFontListCreate** — A font list function that creates a font list

## SYNOPSIS

```
#include <Xm/Xm.h>
XmFontList XmFontListCreate(
XFontStruct * font,
XmStringCharSet charset);
```

## DESCRIPTION

**XmFontListCreate** creates a new font list with a single element specified by the provided font and character set. It also allocates the space for the font list.

**NOTE:** This function is obsolete and exists for compatibility with previous releases. It is replaced by **XmFontListAppendEntry**.

- *font*

  Specifies a pointer to a font structure for which the new font list is generated. This is the structure returned by the XLib **XLoadQueryFont** function.

- *charset*

  Specifies the character set identifier for the font. This can be **XmSTRING\_DEFAULT\_CHARSET**, but this value does not comply with the AES, and it may be removed in future versions of Motif. If the value is **XmSTRING\_DEFAULT\_CHARSET**, the routine derives the character set from the current language environment.

## RETURN

Returns NULL if *font* or *charset* is NULL; otherwise, returns a new font list.

## RELATED

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