Provided by: libmotif-dev_2.3.3-5ubuntu1_amd64 bug

NAME

       XmFontListNextEntry — A font list function that returns the next entry in a font list

SYNOPSIS

       #include <Xm/Xm.h>
       XmFontListEntry XmFontListNextEntry(
       XmFontContext context);

DESCRIPTION

       XmFontListNextEntry  returns  the  next  entry  in the font list. The application uses the
       XmFontListInitFontContext routine to create  a  font  list  context.  The  first  call  to
       XmFontListNextEntry  sets the context to the first entry in the font list. The application
       then calls XmFontListNextEntry repeatedly with the  same  context.  Each  succeeding  call
       accesses  the  next  entry  of  the  font  list.  When  finished,  the  application  calls
       XmFontListFreeFontContext to free the allocated font list context.

       context   Specifies the font list context

RETURN

       Returns NULL if the context does not refer to a valid entry or if it is at the end of  the
       font  list;  otherwise,  it returns a font list entry.  If the function does return a font
       list entry, the font list entry is not a copy. Therefore, the application should not  free
       the returned font list entry.

RELATED

       XmFontList(3),              XmFontListEntryFree(3),             XmFontListEntryGetFont(3),
       XmFontListEntryGetTag(3), XmFontListFreeFontContext(3), and XmFontListInitFontContext(3).

                                                                XmFontListNextEntry(library call)