


XListFonts(3X11)					     XListFonts(3X11)
X11R5									X11R5



NAME
  XListFonts, XFreeFontNames, XListFontsWithInfo, XFreeFontInfo	- obtain or
  free font names and information

SYNTAX
  char **XListFonts(_d_i_s_p_l_a_y, _p_a_t_t_e_r_n, _m_a_x_n_a_m_e_s,	_a_c_t_u_a_l__c_o_u_n_t__r_e_t_u_r_n)
	Display	*_d_i_s_p_l_a_y;
	char *_p_a_t_t_e_r_n;
	int _m_a_x_n_a_m_e_s;
	int *_a_c_t_u_a_l__c_o_u_n_t__r_e_t_u_r_n;

  XFreeFontNames(_l_i_s_t)
	char *_l_i_s_t[];

  char **XListFontsWithInfo(_d_i_s_p_l_a_y, _p_a_t_t_e_r_n, _m_a_x_n_a_m_e_s,	_c_o_u_n_t__r_e_t_u_r_n,
  _i_n_f_o__r_e_t_u_r_n)
	Display	*_d_i_s_p_l_a_y;
	char *_p_a_t_t_e_r_n;
	int _m_a_x_n_a_m_e_s;
	int *_c_o_u_n_t__r_e_t_u_r_n;
	XFontStruct **_i_n_f_o__r_e_t_u_r_n;

  XFreeFontInfo(_n_a_m_e_s, _f_r_e_e__i_n_f_o, _a_c_t_u_a_l__c_o_u_n_t)
	char **_n_a_m_e_s;
	XFontStruct *_f_r_e_e__i_n_f_o;
	int _a_c_t_u_a_l__c_o_u_n_t;

ARGUMENTS

  _a_c_t_u_a_l__c_o_u_n_t
	    Specifies the actual number	of matched font	names returned by
	    _X_L_i_s_t_F_o_n_t_s_W_i_t_h_I_n_f_o.

  _a_c_t_u_a_l__c_o_u_n_t__r_e_t_u_r_n
	    Returns the	actual number of font names.

  _c_o_u_n_t__r_e_t_u_r_n
	    Returns the	actual number of matched font names.

  _d_i_s_p_l_a_y   Specifies the connection to	the X server.

  _i_n_f_o__r_e_t_u_r_n
	    Returns the	font information.

  _f_r_e_e__i_n_f_o Specifies the font information returned by _X_L_i_s_t_F_o_n_t_s_W_i_t_h_I_n_f_o.

  _l_i_s_t	    Specifies the array	of strings you want to free.

  _m_a_x_n_a_m_e_s  Specifies the maximum number of names to be	returned.

  _n_a_m_e_s	    Specifies the list of font names returned by _X_L_i_s_t_F_o_n_t_s_W_i_t_h_I_n_f_o.

  _p_a_t_t_e_r_n   Specifies the null-terminated pattern string that can contain
	    wildcard characters.




DESCRIPTION
  The _X_L_i_s_t_F_o_n_t_s function returns an array of available	font names (as con-
  trolled by the font search path; see _X_S_e_t_F_o_n_t_P_a_t_h) that match	the string
  you passed to	the pattern argument.  The pattern string can contain any
  characters, but each asterisk	(*) is a wildcard for any number of charac-
  ters,	and each question mark (?) is a	wildcard for a single character.  If
  the pattern string is	not in the Host	Portable Character Encoding the
  result is implementation dependent.  Use of uppercase	or lowercase does not
  matter.  Each	returned string	is null-terminated.  If	the data returned by
  the server is	in the Latin Portable Character	Encoding, then the returned
  strings are in the Host Portable Character Encoding.	Otherwise, the result
  is implementation dependent.	If there are no	matching font names, _X_L_i_s_t_-
  _F_o_n_t_s	returns	NULL.  The client should call _X_F_r_e_e_F_o_n_t_N_a_m_e_s when finished
  with the result to free the memory.

  The _X_F_r_e_e_F_o_n_t_N_a_m_e_s function frees the	array and strings returned by _X_L_i_s_t_-
  _F_o_n_t_s	or _X_L_i_s_t_F_o_n_t_s_W_i_t_h_I_n_f_o.

  The _X_L_i_s_t_F_o_n_t_s_W_i_t_h_I_n_f_o function returns a list of font names that match the
  specified pattern and	their associated font information.  The	list of	names
  is limited to	size specified by maxnames.  The information returned for
  each font is identical to what _X_L_o_a_d_Q_u_e_r_y_F_o_n_t	would return except that the
  per-character	metrics	are not	returned.  The pattern string can contain any
  characters, but each asterisk	(*) is a wildcard for any number of charac-
  ters,	and each question mark (?) is a	wildcard for a single character.  If
  the pattern string is	not in the Host	Portable Character Encoding the
  result is implementation dependent.  Use of uppercase	or lowercase does not
  matter.  Each	returned string	is null-terminated.  If	the data returned by
  the server is	in the Latin Portable Character	Encoding, then the returned
  strings are in the Host Portable Character Encoding.	Otherwise, the result
  is implementation dependent.	If there are no	matching font names, _X_L_i_s_t_-
  _F_o_n_t_s_W_i_t_h_I_n_f_o	returns	NULL.

  To free only the allocated name array, the client should call
  _X_F_r_e_e_F_o_n_t_N_a_m_e_s.  To free both	the name array and the font information
  array, or to free just the font information array, the client	should call
  _X_F_r_e_e_F_o_n_t_I_n_f_o.

  The _X_F_r_e_e_F_o_n_t_I_n_f_o function frees the font information	array.	To free	an
  _X_F_o_n_t_S_t_r_u_c_t structure	without	closing	the font, call _X_F_r_e_e_F_o_n_t_I_n_f_o with the
  names	argument specified as NULL.

SEE ALSO
  XLoadFont(3X11), XSetFontPath(3X11)
  _X_l_i_b - _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e





















