FcFontSort(3)															     FcFontSort(3)

NAME

       FcFontSort - Return list of matching fonts

SYNOPSIS

       cc [ flag... ] file... -lfontconfig [ library... ]

       #include <fontconfig.h>

       FcFontSet * FcFontSort (FcConfig *config, FcPattern *p, FcBool trim, FcCharSet **csp, FcResult *result);

DESCRIPTION

       Returns	the list of fonts sorted by closeness to p.  If trim is FcTrue, elements in the list which don't include Unicode coverage not pro-
       vided by earlier elements in the list are elided.  The union of Unicode coverage of all of the fonts is returned in  csp,  if  csp  is  not
       NULL.   This  function should be called only after FcConfigSubstitute and FcDefaultSubstitute have been called for p; otherwise the results
       will not be correct.

       The returned FcFontSet references FcPattern structures which may be shared by the return value from multiple FcFontSort calls, applications
       must  not  modify  these patterns.  Instead, they should be passed, along with p to FcFontRenderPrepare which combines them into a complete
       pattern.

       The FcFontSet returned by FcFontSort is destroyed by caling FcFontSetDestroy.

VERSION

       Fontconfig version 2.5.0

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWfontconfig		   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Volatile			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |See XInitThreads(3X11)	   |
       +-----------------------------+-----------------------------+

								 13 November 2007						     FcFontSort(3)