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

FreeBSD Manual Pages

  
 
  

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

NAME
       XmStringUnparse -- A compound string function that unparses text

SYNOPSIS
       #include	<Xm/Xm.h>
       XtPointer XmStringUnparse(
       XmString	string,
       XmStringTag tag,
       XmTextType tag_type,
       XmTextType output_type,
       XmParseTable parse_table,
       Cardinal	parse_count,
       XmParseModel parse_model);

DESCRIPTION
       XmStringUnparse	looks  in  the input string for	text segments that are
       tagged with locale or charset tags that match tag. The tag_type parame-
       ter specifies whether the tag is	a locale or charset type.  If tag  has
       a  value	 of NULL, all the segments are matched.	When a text segment is
       found with a matching tag, it is	 added	to  the	 end  of  a  resulting
       string. The characters in the resulting string are of type output_type.

       XmStringUnparse also checks string for components that match components
       in  parse_table,	and also to see	if the component matches the condition
       specified by parse_model. If  the  string  component  matches  in  both
       checks,	then  the  associated character	is added to the	end of the re-
       sulting string.

       string	 Specifies the XmString	to be converted.

       tag	 Specifies the tag to be used in matching with text  segments.
		 Only text segments that match tag will	be included in the re-
		 sulting  string. If tag has a value of	NULL, all segments are
		 considered as matches,	and tag_type is	ignored.

       tag_type	 Specifies the type of tag to be searched for,	including  Xm-
		 MULTIBYTE_TEXT, XmWIDECHAR_TEXT, and XmCHARSET_TEXT.

       output_type
		 Specifies  the	type of	text to	be returned in the string, in-
		 cluding   XmMULTIBYTE_TEXT,	XmWIDECHAR_TEXT,    and	   Xm-
		 CHARSET_TEXT.

       parse_table
		 Specifies the parse table to be used in scanning for compound
		 string	components to be converted to other characters.

       parse_count
		 Specifies how many entries are	in parse_table.

       parse_model
		 Specifies  which  non-text  components	 to  be	 considered in
		 matching in parse_table. These	include:

		 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 a newly allocated string	containing characters of a type	deter-
       mined by	output_type.  The application is responsible for managing this
       allocated  space.   The application can recover this allocated space by
       calling XtFree.

RELATED
       XmString(3), XmParseTable(3), XmParseMapping(3).

							    XmStringUnparse(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=XmStringUnparse&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>

home | help