xmfontlistremoveentry(3x) [osf1 man page]

XmFontListRemoveEntry(3X)												 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;
	       XmFontListEntry entry;

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.	 Specifies
       the font list Specifies the font list entry to be removed

RETURN VALUE

       If  oldlist  is NULL, the function returns NULL.  If entry is NULL or no entries are removed,  the function returns oldlist.  Otherwise, it
       returns a new font list.

SEE ALSO

       XmFontList(3X), XmFontListAppendEntry(3X), XmFontListEntryCreate(3X), XmFontListEntryFree(3X), XmFontListEntryLoad(3X), XmFontListFree(3X)

															 XmFontListRemoveEntry(3X)

XmFontListRemoveEntry(library call)									       XmFontListRemoveEntry(library call)

NAME

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

SYNOPSIS

       #include <Xm/Xm.h>
       XmFontList XmFontListRemoveEntry(
       XmFontList oldlist,
       XmFontListEntry entry);

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 spec-
       ified entry. This routine does not free the XFontSet or XFontStruct associated with the font list entry that is removed.

       oldlist	 Specifies the font list

       entry	 Specifies the font list entry to be removed

RETURN

       If oldlist is NULL, the function returns NULL. If entry is NULL or no entries are removed, the  function  returns  oldlist.  Otherwise,	it
       returns	a new font list.  If the function returns a new font list, the function allocates space to hold the new font list. The application
       is responsible for managing the allocated space. The application can recover the allocated space by calling XmFontListFree.

RELATED

       XmFontList(3), XmFontListAppendEntry(3), XmFontListEntryCreate(3), XmFontListEntryFree(3), XmFontListEntryLoad(3), and XmFontListFree(3).

													       XmFontListRemoveEntry(library call)