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

FreeBSD Manual Pages

  
 
  

home | help
XmStringTa...StringArray(3) Library Functions Manual XmStringTa...StringArray(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  Xm-
     StringTable  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 in-
	       dicates 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_DE-
	       FAULT_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  lo-
	       cale  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  Xm-
     StringTable.   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 deallo-
     cate the XmStringTable itself.

RELATED
     XmStringFree(3) and XmTabList(3).

						     XmStringTa...StringArray(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+15.1.quarterly>

home | help