


XStringListToTextProperty(3X11)		      XStringListToTextProperty(3X11)
X11R5									X11R5



NAME
  XStringListToTextProperty, XTextPropertyToStringList,	XFreeStringList,
  XTextProperty	- convert string lists and text	property structure

SYNTAX
  Status XStringListToTextProperty(_l_i_s_t, _c_o_u_n_t,	_t_e_x_t__p_r_o_p__r_e_t_u_r_n)
	char **_l_i_s_t;
	int _c_o_u_n_t;
	XTextProperty *_t_e_x_t__p_r_o_p__r_e_t_u_r_n;

  Status XTextPropertyToStringList(_t_e_x_t__p_r_o_p, _l_i_s_t__r_e_t_u_r_n, _c_o_u_n_t__r_e_t_u_r_n)
	 XTextProperty *_t_e_x_t__p_r_o_p;
	 char ***_l_i_s_t__r_e_t_u_r_n;
	 int *_c_o_u_n_t__r_e_t_u_r_n;

  void XFreeStringList(_l_i_s_t)
	char **_l_i_s_t;

ARGUMENTS

  _c_o_u_n_t	    Specifies the number of strings.

  _c_o_u_n_t__r_e_t_u_r_n
	    Returns the	number of strings.

  _l_i_s_t	    Specifies the list of strings to be	freed.

  _l_i_s_t	    Specifies a	list of	null-terminated	character strings.

  _l_i_s_t__r_e_t_u_r_n
	    Returns a list of null-terminated character	strings.

  _t_e_x_t__p_r_o_p Specifies the _X_T_e_x_t_P_r_o_p_e_r_t_y	structure to be	used.

  _t_e_x_t__p_r_o_p__r_e_t_u_r_n
	    Returns the	_X_T_e_x_t_P_r_o_p_e_r_t_y structure.

DESCRIPTION
  The _X_S_t_r_i_n_g_L_i_s_t_T_o_T_e_x_t_P_r_o_p_e_r_t_y	function sets the specified _X_T_e_x_t_P_r_o_p_e_r_t_y to
  be of	type STRING (format 8) with a value representing the concatenation of
  the specified	list of	null-separated character strings.  An extra null byte
  (which is not	included in the	nitems member) is stored at the	end of the
  value	field of text_prop_return.  The	strings	are assumed (without verifi-
  cation) to be	in the STRING encoding.	 If insufficient memory	is available
  for the new value string, _X_S_t_r_i_n_g_L_i_s_t_T_o_T_e_x_t_P_r_o_p_e_r_t_y does not set any fields
  in the _X_T_e_x_t_P_r_o_p_e_r_t_y structure and returns a zero status.  Otherwise,	it
  returns a nonzero status.  To	free the storage for the value field, use
  _X_F_r_e_e.

  The _X_T_e_x_t_P_r_o_p_e_r_t_y_T_o_S_t_r_i_n_g_L_i_s_t	function returns a list	of strings represent-
  ing the null-separated elements of the specified _X_T_e_x_t_P_r_o_p_e_r_t_y structure.
  The data in text_prop	must be	of type	STRING and format 8. Multiple
  elements of the property (for	example, the strings in	a disjoint text
  selection) are separated by NULL (encoding 0).  The contents of the pro-
  perty	are not	null-terminated.  If insufficient memory is available for the
  list and its elements, _X_T_e_x_t_P_r_o_p_e_r_t_y_T_o_S_t_r_i_n_g_L_i_s_t sets	no return values and
  returns a zero status.  Otherwise, it	returns	a nonzero status.  To free
  the storage for the list and its contents, use _X_F_r_e_e_S_t_r_i_n_g_L_i_s_t.

  The _X_F_r_e_e_S_t_r_i_n_g_L_i_s_t function releases	memory allocated by _X_m_b_T_e_x_t_P_r_o_p_e_r_-
  _t_y_T_o_T_e_x_t_L_i_s_t and _X_T_e_x_t_P_r_o_p_e_r_t_y_T_o_S_t_r_i_n_g_L_i_s_t, and the missing charset list
  allocated by _X_C_r_e_a_t_e_F_o_n_t_S_e_t.

STRUCTURES
  The _X_T_e_x_t_P_r_o_p_e_r_t_y structure contains:

  typedef struct	  {
	  unsigned char	*value;	  /* property data */
	  Atom encoding;  /* type of property */
	  int format;	  /* 8,	16, or 32 */
	  unsigned long	nitems;	 /* number of items in value */
  } XTextProperty;

SEE ALSO
  XAllocClassHint(3X11), XAllocIconSize(3X11), XAllocSizeHints(3X11),
  XAllocWMHints(3X11), XFree(3X11), XSetCommand(3X11),
  XSetTransientForHint(3X11), XSetTextProperty(3X11),
  XSetWMClientMachine(3X11), XSetWMColormapWindows(3X11),
  XSetWMIconName(3X11),	XSetWMName(3X11), XSetWMProperties(3X11),
  XSetWMProtocols(3X11)
  _X_l_i_b - _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e	delim off











































