xmstringunparse(3) [redhat man page]

XmStringUnparse(library call)											     XmStringUnparse(library call)

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 param-
       eter 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 condi-
       tion specified by parse_model. If the string component matches in both checks, then the associated character is added to  the  end  of  the
       resulting 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 resulting
		 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 XmMULTIBYTE_TEXT, XmWIDECHAR_TEXT, and XmCHARSET_TEXT.

       output_type
		 Specifies the type of text to be returned in the string, including XmMULTIBYTE_TEXT, XmWIDECHAR_TEXT, and XmCHARSET_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 determined 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(library call)

Check Out this Related Man Page

XmStringTableUnparse(library call)										XmStringTableUnparse(library call)

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 include XmMULTIBYTE_TEXT, XmWIDECHAR_TEXT, and XmCHARSET_TEXT.

       output_type
		 Specifies the type of text to be generated. These types include 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
       recover	the allocated strings space by calling XtFree count times (that is, one time for each allocated string).  The application can then
       recover the allocated array by calling XtFree on the allocated array itself.

RELATED

       XmStringTab.

														XmStringTableUnparse(library call)

Linux and UNIX Man Pages

xmstringunparse(3) [redhat man page]

Check Out this Related Man Page