xmstringtableparsestringarray(3) [centos man page]

XmStringTableParseStringArray(library call)							       XmStringTableParseStringArray(library call)

NAME

       XmStringTableParseStringArray -- A convenience function that converts an array of strings to a compound string table

SYNOPSIS

       #include <Xm/Xm.h>
       XmStringTable XmStringTableParseStringArray(
       XtPointer *strings,
       Cardinal count,
       XmStringTag tag,
       XmTextType type,
       XmParseTable parse,
       Cardinal parse_count,
       XtPointer call_data);

DESCRIPTION

       XmStringTableParseStringArray  takes an array of strings, allocates an XmStringTable with an equal number of slots, calls XmStringParseText
       on each string in strings, and inserts the resulting XmString in the corresponding slot in the XmStringTable.

       strings	 Specifies an array of strings of characters as determined by type.

       count	 Specifies the number of strings in strings.

       tag	 Specifies the tag to be used in creating the result. The type of tag created (charset or locale) depends on the type of the  text
		 and  the  value given. If the value specified is NULL, and type indicates that a charset tag should be created, then the tag will
		 have  the  value  of  XmFONTLIST_DEFAULT_TAG.	 If  type  indicates  a  locale  tag,  then  the  tag  will  have  the	value	of
		 XmFONTLIST_DEFAULT_TAG.

       type	 Specifies  the  type  of  text  to be passed in and the type of tag. If the type is either XmMULTIBYTE_TEXT or XmWIDECHAR_TEXT, a
		 locale tag should be created. If the type is XmCHARSET_TEXT, a charset tag will be created.

       parse	 Specifies the parse table to be used.

       parse_count
		 Specifies the number of entries in the parse table.

       call_data Specifies data to be passed to the parse procedures.

RETURN

       Returns a new XmStringTable.  The function allocates space to hold the XmStringTable.  When the application no longer  needs  the  returned
       XmStringTable,  the  application  should  call XmStringFree count times (that is, one time for each returned compound string) and then call
       XtFree to deallocate the XmStringTable itself.

RELATED

       XmStringFree(3) and XmTabList(3).

												       XmStringTableParseStringArray(library call)

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)