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

FreeBSD Manual Pages

  
 
  

home | help
XmStringT...tringArray(3)  Library Functions Manual  XmStringT...tringArray(3)

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 cor-
       responding 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 Xm-
       StringTable, 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).

						     XmStringT...tringArray(3)

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

home | help