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

# XmFontListEntryLoad(3)

A font list function that loads a font or creates a font set and creates an accompanying font list entry

## NAME

**XmFontListEntryLoad** — A font list function that loads a font or creates a font set and creates an accompanying font list entry

## SYNOPSIS

```
#include <Xm/Xm.h>
XmFontListEntry XmFontListEntryLoad(
Display *display,
char *font_name,
XmFontType type,
char *tag);
```

## DESCRIPTION

**XmFontListEntryLoad** loads a font or creates a font set based on the value of the *type* argument. It creates and returns a font list entry that contains the font or font set and the specified tag.

If the value of *type* is **XmFONT\_IS\_FONT**, the function uses the **XtCvtStringToFontStruct** routine to convert the value of *font\_name* to a font struct. If the value of *type* is **XmFONT\_IS\_FONTSET**, the function uses the **XtCvtStringToFontSet** converter to create a font set in the current locale. **XmFontListEntryLoad** creates a font list entry that contains the font or font set derived from the converter. For more information about **XtCvtStringToFontStruct** and **XtCvtStringToFontSet**, see *X Toolkit Intrinsics—C Language* *Interface.*

- *display*

  Specifies the display where the font list will be used.

- *font\_name*

  Specifies an X Logical Font Description (XLFD) string, which is interpreted either as a font name or as a base font name list. A base font name list is a comma-separated and NULL-terminated string.

- *type*

  Specifies whether the *font\_name* argument refers to a font name or to a base font name list. Valid values are **XmFONT\_IS\_FONT** and **XmFONT\_IS\_FONTSET**.

- *tag*

  Specifies the tag of the font list entry to be created. The tag may be specified as **XmFONTLIST\_DEFAULT\_TAG**, which is used to identify the default font list element in a font list when specified as part of a resource.

## RETURN

If the specified font is not found, or if the specified font set cannot be created, then either an implementation-defined font will be opened or a font set will be created, and a warning messge will be generated. If no suitable font can be found or a font set cannot be created, then another message will be generated and the function will return NULL; otherwise the function returns a font list entry. If the function returns a font list entry, the function allocates space to hold the font list entry. The application is responsible for managing the allocated space. The application can recover the allocated space by calling **XmFontListEntryFree**.

## RELATED

[**XmFontList**(3)](/XmFontList/3.md), [**XmFontListAppendEntry**(3)](/XmFontListAppendEntry/3.md), [**XmFontListEntryCreate**(3)](/XmFontListEntryCreate/3.md), [**XmFontListEntryFree**(3)](/XmFontListEntryFree/3.md), [**XmFontListEntryGetFont**(3)](/XmFontListEntryGetFont/3.md), [**XmFontListEntryGetTag**(3)](/XmFontListEntryGetTag/3.md), and [**XmFontListRemoveEntry**(3)](/XmFontListRemoveEntry/3.md).