noble (3) XmStringTableParseStringArray.3.gz

Provided by: libmotif-dev_2.3.8-3.1build1_amd64 bug

NAME
       XmStringTableParseStringArray  —  A  convenience function that converts an array of strings to a compound
       string table "XmStringTableParseStringArray"


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.


       XmStringFree(3) and XmTabList(3).

                                                                                XmStringTableParseStringArray(3)