XmFontListRemoveEntry(3X)

NAME
     XmFontListRemoveEntry --A font list function that removes a font list entry
     from a font list

SYNOPSIS
     #include <Xm/Xm.h>

     XmFontList XmFontListRemoveEntry (oldlist, entry)
          XmFontList  oldlist;
          XmFontListEntryentry;


VERSION
     This page documents version 1.2 of the Motif library.

DESCRIPTION
     XmFontListRemoveEntry creates a new font list that contains the contents of
     oldlist  minus  those  entries specified in entry.  The routine removes any
     entries from oldlist that match the components (tag, type font/font set) of
     the specified entry.  The function deallocates the original font list after
     extracting the required information.  The caller  uses  XmFontListEntryFree
     to recover memory allocated for the specified entry.  This routine does not
     free  the  XFontSet or XFontStruct associated with the font list entry that
     is removed.


     oldlistSpecifies the font list

     entry  Specifies the font list entry to be removed


RETURN VALUE
     If oldlist is NULL, the function returns NULL.  If entry is NULL or no  en-
     tries are removed,  the  function returns oldlist.  Otherwise, it returns a
     new font list.

RELATED INFORMATION
     XmFontList(3X), XmFontListAppendEntry(3X), XmFontListEntryCreate(3X), Xm-
     FontListEntryFree(3X), XmFontListEntryLoad(3X), and XmFontListFree(3X).

                                                       XmFontListRemoveEntry(3X)