home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / Xm / XmStringTableUnparse.z / XmStringTableUnparse
Encoding:
Text File  |  2002-10-03  |  7.7 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmSSSSttttrrrriiiinnnnggggTTTTaaaabbbblllleeeeUUUUnnnnppppaaaarrrrsssseeee((((3333XXXX))))  UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV  XXXXmmmmSSSSttttrrrriiiinnnnggggTTTTaaaabbbblllleeeeUUUUnnnnppppaaaarrrrsssseeee((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XXXXmmmmSSSSttttrrrriiiinnnnggggTTTTaaaabbbblllleeeeUUUUnnnnppppaaaarrrrsssseeee - A convenience function that converts
  10.           a table of compound strings to an array of text
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           #include <Xm/Xm.h>
  14.           XXXXttttPPPPooooiiiinnnntttteeeerrrr **** XXXXmmmmSSSSttttrrrriiiinnnnggggTTTTaaaabbbblllleeeeUUUUnnnnppppaaaarrrrsssseeee(
  15.           XXXXmmmmSSSSttttrrrriiiinnnnggggTTTTaaaabbbblllleeee ttttaaaabbbblllleeee,
  16.           CCCCaaaarrrrddddiiiinnnnaaaallll ccccoooouuuunnnntttt,
  17.           XXXXmmmmSSSSttttrrrriiiinnnnggggTTTTaaaagggg ttttaaaagggg,
  18.           XXXXmmmmTTTTeeeexxxxttttTTTTyyyyppppeeee ttttaaaagggg____ttttyyyyppppeeee,
  19.           XXXXmmmmTTTTeeeexxxxttttTTTTyyyyppppeeee oooouuuuttttppppuuuutttt____ttttyyyyppppeeee,
  20.           XXXXmmmmPPPPaaaarrrrsssseeeeTTTTaaaabbbblllleeee ppppaaaarrrrsssseeee,
  21.           CCCCaaaarrrrddddiiiinnnnaaaallll ppppaaaarrrrsssseeee____ccccoooouuuunnnntttt,
  22.           XXXXmmmmPPPPaaaarrrrsssseeeeMMMMooooddddeeeellll ppppaaaarrrrsssseeee____mmmmooooddddeeeellll);
  23.  
  24.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  25.           This page documents Motif 2.1.
  26.  
  27.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  28.           XXXXmmmmSSSSttttrrrriiiinnnnggggTTTTaaaabbbblllleeeeUUUUnnnnppppaaaarrrrsssseeee takes an array of compound strings,
  29.           allocates a string array for the type of characters
  30.           determined by _t_y_p_e with an equal number of slots, calls
  31.           XXXXmmmmSSSSttttrrrriiiinnnnggggUUUUnnnnppppaaaarrrrsssseeeeon each compound string in _t_a_b_l_e, and inserts
  32.           the resulting string in the corresponding slot in the array.
  33.  
  34.           _t_a_b_l_e     Specifies an XXXXmmmmSSSSttttrrrriiiinnnnggggTTTTaaaabbbblllleeee containing the compound
  35.                     string to be converted.
  36.  
  37.           _c_o_u_n_t     Specifies the number of compound strings in _t_a_b_l_e.
  38.  
  39.           _t_a_g       Specifies the tag to be used in matching with text
  40.                     segments.  The two types of tag types are
  41.                     XXXXmmmmFFFFOOOONNNNTTTTLLLLIIIISSSSTTTT____DDDDEEEEFFFFAAAAUUUULLLLTTTT____TTTTAAAAGGGG and ____MMMMOOOOTTTTIIIIFFFF____DDDDEEEEFFFFAAAAUUUULLLLTTTT____LLLLOOOOCCCCAAAALLLLEEEE.
  42.                     Only segments tagged with _t_a_gwill be returned. If
  43.                     _t_a_g is NULL, all segments will be matched.
  44.  
  45.           _t_a_g__t_y_p_e  Specifies the type of tag to be searched for.
  46.                     These types include XXXXmmmmMMMMUUUULLLLTTTTIIIIBBBBYYYYTTTTEEEE____TTTTEEEEXXXXTTTT,
  47.                     XXXXmmmmWWWWIIIIDDDDEEEECCCCHHHHAAAARRRR____TTTTEEEEXXXXTTTT, and XXXXmmmmCCCCHHHHAAAARRRRSSSSEEEETTTT____TTTTEEEEXXXXTTTT.
  48.  
  49.           _o_u_t_p_u_t__t_y_p_e
  50.                     Specifies the type of text to be generated. These
  51.                     types include XXXXmmmmMMMMUUUULLLLTTTTIIIIBBBBYYYYTTTTEEEE____TTTTEEEEXXXXTTTT, XXXXmmmmWWWWIIIIDDDDEEEECCCCHHHHAAAARRRR____TTTTEEEEXXXXTTTT,
  52.                     and XXXXmmmmCCCCHHHHAAAARRRRSSSSEEEETTTT____TTTTEEEEXXXXTTTT.
  53.  
  54.           _p_a_r_s_e     Specifies the parse table to be used.
  55.  
  56.           _p_a_r_s_e__c_o_u_n_t
  57.                     Specifies the number of items in _p_a_r_s_e.
  58.  
  59.           _p_a_r_s_e__m_o_d_e_l
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 10/3/02)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmSSSSttttrrrriiiinnnnggggTTTTaaaabbbblllleeeeUUUUnnnnppppaaaarrrrsssseeee((((3333XXXX))))  UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV  XXXXmmmmSSSSttttrrrriiiinnnnggggTTTTaaaabbbblllleeeeUUUUnnnnppppaaaarrrrsssseeee((((3333XXXX))))
  71.  
  72.  
  73.  
  74.                     Specifies which non-text components to be
  75.                     considered in matching in _p_a_r_s_e__t_a_b_l_e. Possible
  76.                     values are:
  77.  
  78.                     XXXXmmmmOOOOUUUUTTTTPPPPUUUUTTTT____AAAALLLLLLLL
  79.                               Puts out all matching components.
  80.  
  81.                     XXXXmmmmOOOOUUUUTTTTPPPPUUUUTTTT____BBBBEEEETTTTWWWWEEEEEEEENNNN
  82.                               Puts out only those matching components
  83.                               that are between two matching text
  84.                               components.
  85.  
  86.                     XXXXmmmmOOOOUUUUTTTTPPPPUUUUTTTT____BBBBEEEEGGGGIIIINNNNNNNNIIIINNNNGGGG
  87.                               Puts out only those matching components
  88.                               that are at the beginning of a matching
  89.                               text component.
  90.  
  91.                     XXXXmmmmOOOOUUUUTTTTPPPPUUUUTTTT____EEEENNNNDDDD
  92.                               Puts out only those matching components
  93.                               that are at the end of a matching text
  94.                               component.
  95.  
  96.                     XXXXmmmmOOOOUUUUTTTTPPPPUUUUTTTT____BBBBOOOOTTTTHHHH
  97.                               Puts out only those matching components
  98.                               that are at the beginning or end of a
  99.                               matching text component.
  100.  
  101.      RRRREEEETTTTUUUURRRRNNNN
  102.           Returns an allocated array of allocated strings.  The
  103.           application is responsible for managing the allocated space.
  104.           The application can recover the allocated strings space by
  105.           calling XXXXttttFFFFrrrreeeeeeee_c_o_u_n_t times (that is, one time for each
  106.           allocated string).  The application can then recover the
  107.           allocated array by calling XXXXttttFFFFrrrreeeeeeee on the allocated array
  108.           itself.
  109.  
  110.      RRRREEEELLLLAAAATTTTEEEEDDDD
  111.           XXXXmmmmSSSSttttrrrriiiinnnnggggTTTTaaaabbbb....
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 10/3/02)
  130.  
  131.  
  132.  
  133.