Museum

 XmFontListAppendEntry(Xm)      6 January 1993      XmFontListAppendEntry(Xm)


 Name

    XmFontListAppendEntry - a font list function that appends an entry to a
    font list

 Syntax


    #include <Xm/Xm.h>

    XmFontList XmFontListAppendEntry (oldlist, entry)
    XmFontList oldlist;
    XmFontListEntry entry;


 Description

    XmFontListAppendEntry creates a new font list that contains the contents
    of oldlist. This function copies the contents of the font list entry
    being added into this new font list. If oldlist is NULL, XmFontListAppen-
    dEntry creates a new font list containing only the single entry speci-
    fied.

    This function deallocates the original font list after extracting the
    required information. The caller must free the font list entry by using
    XmFontListEntryFree.

    oldlist Specifies the font list to be added to

    entry   Specifies the font list entry to be added

 Return value

    If entry is NULL, returns oldlist; otherwise, returns a new font list.

 See also

    XmFontList(Xm), XmFontListEntryCreate(Xm), XmFontListEntryFree(Xm),
    XmFontListEntryLoad(Xm), XmFontListFree(Xm) and
    XmFontListRemoveEntry(Xm).