NAME

       XmRegisterSegmentEncoding  —  A  compound  string  function that registers a compound text
       encoding format for  a  specified  font  list  element  tag  "XmRegisterSegment\%Encoding"
       "compound string functions" "XmRegisterSegment\%Encoding"

SYNOPSIS

       #include <Xm/Xm.h>
       char * XmRegisterSegmentEncoding(
       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

       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

       XmCvtXmStringToCT(3), XmFontList(3), XmMapSegmentEncoding(3), and XmString(3).

                                                                     XmRegisterSegmentEncoding(3)