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

# XmStringCreate(3)

A compound string function that creates a compound string

## NAME

**XmStringCreate** — A compound string function that creates a compound string

## SYNOPSIS

```
#include <Xm/Xm.h>
XmString XmStringCreate(
char *text,
char *tag);
```

## DESCRIPTION

**XmStringCreate** creates a compound string with two components: text and a font list element tag. The function will allocate space to hold the returned compound string. When the application no longer needs the returned compound string, the application should call **XmStringFree**.

- *text*

  Specifies a NULL-terminated string to be used as the text component of the compound string.

- *tag*

  Specifies the tag component to be associated with the given text. The value **XmFONTLIST\_DEFAULT\_TAG** identifies a locale text segment.

## RETURN

Returns a new compound string.

## RELATED

[**XmFontList**(3)](/XmFontList/3.md), [**XmFontListAdd**(3)](/XmFontListAdd/3.md), [**XmFontListAppendEntry**(3)](/XmFontListAppendEntry/3.md), [**XmFontListCopy**(3)](/XmFontListCopy/3.md), [**XmFontListCreate**(3)](/XmFontListCreate/3.md), [**XmFontListEntryCreate**(3)](/XmFontListEntryCreate/3.md), [**XmFontListEntryFree**(3)](/XmFontListEntryFree/3.md), [**XmFontListEntryGetFont**(3)](/XmFontListEntryGetFont/3.md), [**XmFontListEntryGetTag**(3)](/XmFontListEntryGetTag/3.md), [**XmFontListEntryLoad**(3)](/XmFontListEntryLoad/3.md), [**XmFontListFree**(3)](/XmFontListFree/3.md), [**XmFontListFreeFontContext**(3)](/XmFontListFreeFontContext/3.md), [**XmFontListGetNextFont**(3)](/XmFontListGetNextFont/3.md), [**XmFontListInitFontContext**(3)](/XmFontListInitFontContext/3.md), [**XmFontListNextEntry**(3)](/XmFontListNextEntry/3.md), [**XmFontListRemoveEntry**(3)](/XmFontListRemoveEntry/3.md), [**XmString**(3)](/XmString/3.md), [**XmStringBaseline**(3)](/XmStringBaseline/3.md), [**XmStringByteCompare**(3)](/XmStringByteCompare/3.md), [**XmStringCompare**(3)](/XmStringCompare/3.md), [**XmStringConcat**(3)](/XmStringConcat/3.md), [**XmStringCopy**(3)](/XmStringCopy/3.md), [**XmStringCreateLocalized**(3)](/XmStringCreateLocalized/3.md), [**XmStringCreateLtoR**(3)](/XmStringCreateLtoR/3.md), [**XmStringCreateSimple**(3)](/XmStringCreateSimple/3.md), [**XmStringDirection**(3)](/XmStringDirection/3.md), [**XmStringDirectionCreate**(3)](/XmStringDirectionCreate/3.md), [**XmStringDraw**(3)](/XmStringDraw/3.md), [**XmStringDrawImage**(3)](/XmStringDrawImage/3.md), [**XmStringDrawUnderline**(3)](/XmStringDrawUnderline/3.md), [**XmStringEmpty**(3)](/XmStringEmpty/3.md), [**XmStringExtent**(3)](/XmStringExtent/3.md), [**XmStringFree**(3)](/XmStringFree/3.md), [**XmStringFreeContext**(3)](/XmStringFreeContext/3.md), [**XmStringGetLtoR**(3)](/XmStringGetLtoR/3.md), [**XmStringGetNextComponent**(3)](/XmStringGetNextComponent/3.md), [**XmStringGetNextSegment**(3)](/XmStringGetNextSegment/3.md), [**XmStringHasSubstring**(3)](/XmStringHasSubstring/3.md), [**XmStringHeight**(3)](/XmStringHeight/3.md), [**XmStringInitContext**(3)](/XmStringInitContext/3.md), [**XmStringLength**(3)](/XmStringLength/3.md), [**XmStringLineCount**(3)](/XmStringLineCount/3.md), [**XmStringNConcat**(3)](/XmStringNConcat/3.md), [**XmStringNCopy**(3)](/XmStringNCopy/3.md), [**XmStringPeekNextComponent**(3)](/XmStringPeekNextComponent/3.md), [**XmStringSegmentCreate**(3)](/XmStringSegmentCreate/3.md), [**XmStringSeparatorCreate**(3)](/XmStringSeparatorCreate/3.md), [**XmStringTable**(3)](/XmStringTable/3.md), and [**XmStringWidth**(3)](/XmStringWidth/3.md).