Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
XmStringTableUnparse(3)	   Library Functions Manual    XmStringTableUnparse(3)

NAME
       XmStringTableUnparse -- A convenience function that converts a table of
       compound	strings	to an array of text

SYNOPSIS
       #include	<Xm/Xm.h>
       XtPointer * XmStringTableUnparse(
       XmStringTable table,
       Cardinal	count,
       XmStringTag tag,
       XmTextType tag_type,
       XmTextType output_type,
       XmParseTable parse,
       Cardinal	parse_count,
       XmParseModel parse_model);

DESCRIPTION
       XmStringTableUnparse takes an array of compound	strings,  allocates  a
       string  array  for  the	type  of characters determined by type with an
       equal number of slots, calls XmStringUnparse on each compound string in
       table,  and  inserts  the resulting string in the corresponding slot in
       the array.

       table	 Specifies an XmStringTable containing the compound string  to
		 be converted.

       count	 Specifies the number of compound strings in table.

       tag	 Specifies  the	tag to be used in matching with	text segments.
		 The two types of tag  types  are  XmFONTLIST_DEFAULT_TAG  and
		 _MOTIF_DEFAULT_LOCALE.	 Only segments tagged with tag will be
		 returned. If tag is NULL, all segments	will be	matched.

       tag_type	 Specifies the type of tag to be searched for. These types in-
		 clude XmMULTIBYTE_TEXT, XmWIDECHAR_TEXT, and XmCHARSET_TEXT.

       output_type
		 Specifies  the	 type of text to be generated. These types in-
		 clude XmMULTIBYTE_TEXT, XmWIDECHAR_TEXT, and XmCHARSET_TEXT.

       parse	 Specifies the parse table to be used.

       parse_count
		 Specifies the number of items in parse.

       parse_model
		 Specifies which  non-text  components	to  be	considered  in
		 matching in parse_table. Possible values are:

		 XmOUTPUT_ALL
			   Puts	out all	matching components.

		 XmOUTPUT_BETWEEN
			   Puts	 out  only  those matching components that are
			   between two matching	text components.

		 XmOUTPUT_BEGINNING
			   Puts	out only those matching	components that	are at
			   the beginning of a matching text component.

		 XmOUTPUT_END
			   Puts	out only those matching	components that	are at
			   the end of a	matching text component.

		 XmOUTPUT_BOTH
			   Puts	out only those matching	components that	are at
			   the beginning or end	of a matching text component.

RETURN
       Returns	an  allocated  array of	allocated strings.  The	application is
       responsible for managing	the allocated space.  The application can  re-
       cover  the  allocated strings space by calling XtFree count times (that
       is, one time for	each allocated string).	 The application can then  re-
       cover  the allocated array by calling XtFree on the allocated array it-
       self.

RELATED
       XmStringTab.

						       XmStringTableUnparse(3)

NAME | SYNOPSIS | DESCRIPTION | RETURN | RELATED

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=XmStringTableUnparse&sektion=3&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help