FcFontSort

FcFontSort(3)							FcFontSort(3)



NAME
       FcFontSort - Return list of matching fonts

SYNOPSIS
       #include <fontconfig.h>

       FcFontSet  *  FcFontSort	 (FcConfig *config, FcPattern *p, FcBooltrim,
       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
       provided 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, applica-
       tions must not modify these patterns.  Instead, they should be passed,
       along  with  p  to FcFontRenderPrepare which combines them into a com-
       plete pattern.

       The FcFontSet returned by FcFontSort is destroyed by caling FcFontSet-
       Destroy.

VERSION
       Fontconfig version 2.2.3



				 30 June 2004			FcFontSort(3)