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

# XmFontListAdd(3)

A font list function that creates a new font list

## NAME

**XmFontListAdd** — A font list function that creates a new font list

## SYNOPSIS

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

## DESCRIPTION

**XmFontListAdd** creates a new font list consisting of the contents of *oldlist* and the new font list element being added. This function deallocates *oldlist* after extracting the required information; therefore, do not reference *oldlist* thereafter.

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

- *oldlist*

  Specifies a pointer to the font list to which an entry will be added.

- *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 *oldlist* is NULL; returns *oldlist* if *font* or *charset* is NULL; otherwise, returns a new font list.

## RELATED

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