SDK X11 R4.11MU05 XmRegisterSegmentEncoding(3X)
NAME
XmRegisterSegmentEncoding--A compound string function that registers
a compound text encoding format for a specified font list element tag
SYNOPSIS
#include <Xm/Xm.h>
char * XmRegisterSegmentEncoding (fontlist_tag, ct_encoding)
char *fontlist_tag;
char *ct_encoding;
DESCRIPTION
XmRegisterSegmentEncoding registers a compound text encoding format
with the specified font list element tag. The XmCvtXmStringToCT
function uses this registry to map the font list tags of compound
string segments to compound text encoding formats. Registering a
font list tag that already exists in the registry overwrites the
original entry. You can unregister a font list tag by passing a NULL
value for the ct_encoding parameter.
fontlist_tag
Specifies the font list element tag to be registered. The
tag must be a NULL-terminated ISO8859-1 string.
ct_encoding
Specifies the compound text character set to be used for
segments with the font list tag. The value must be a NULL-
terminated ISO8859-1 string. A value of
XmFONTLIST_DEFAULT_TAG maps the specified font list tag to
the code set of the locale.
RETURN VALUE
Returns NULL for a new font list tag or the old ct_encoding value for
an already registered font list tag. The application is responsible
for freeing the storage associated with the returned data (if any) by
calling XtFree.
RELATED INFORMATION
XmCvtXmStringToCT(3X), XmFontList(3X), XmMapSegmentEncoding(3X), and
XmString(3X).
Licensed material--property of copyright holder(s)