home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3w / wstring.z / wstring
Encoding:
Text File  |  1998-10-20  |  5.0 KB  |  65 lines

  1.  
  2.  
  3.  
  4. wwwwssssttttrrrriiiinnnngggg((((3333WWWW))))                                                        wwwwssssttttrrrriiiinnnngggg((((3333WWWW))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _wwww_ssss_tttt_rrrr_iiii_nnnn_gggg_:::: _wwww_ssss_ssss_iiii_zzzz_eeee_,,,, _wwww_ssss_tttt_oooo_kkkk_,,,, _ssss_tttt_rrrr_tttt_oooo_wwww_ssss -  _wwww_cccc_hhhh_aaaa_rrrr______tttt string operations and type
  10.      transformation
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_wwww_iiii_dddd_eeee_cccc_...._hhhh_>>>>
  14.      _iiii_nnnn_tttt _wwww_ssss_ssss_iiii_zzzz_eeee_((((_wwww_cccc_hhhh_aaaa_rrrr______tttt _****_s_))))_;;;;
  15.      _wwww_cccc_hhhh_aaaa_rrrr______tttt _****_wwww_ssss_tttt_oooo_kkkk_((((_wwww_cccc_hhhh_aaaa_rrrr______tttt _****_s_1_,,,, _wwww_cccc_hhhh_aaaa_rrrr______tttt _****_s_2_))))_;;;;
  16.      _wwww_cccc_hhhh_aaaa_rrrr______tttt _****_ssss_tttt_rrrr_tttt_oooo_wwww_ssss_((((_wwww_cccc_hhhh_aaaa_rrrr______tttt _****_s_1_,,,, _cccc_hhhh_aaaa_rrrr _****_s_2_))))_;;;;
  17.  
  18. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN ((((IIIInnnntttteeeerrrrnnnnaaaattttiiiioooonnnnaaaallll FFFFuuuunnnnccccttttiiiioooonnnnssss))))
  19.      The arguments _s_1, _s_2, and _s point to _wwww_cccc_hhhh_aaaa_rrrr______tttt strings (that is, arrays of
  20.      _wwww_cccc_hhhh_aaaa_rrrr______tttt characters terminated by a _wwww_cccc_hhhh_aaaa_rrrr______tttt null character).
  21.  
  22.      _wwww_ssss_ssss_iiii_zzzz_eeee returns the number of _wwww_cccc_hhhh_aaaa_rrrr______tttt characters in _s, not including the
  23.      terminating _wwww_cccc_hhhh_aaaa_rrrr______tttt null character.
  24.  
  25.      _wwww_ssss_tttt_oooo_kkkk treats the _wwww_cccc_hhhh_aaaa_rrrr______tttt string _s_1 as a sequence of zero or more text
  26.      tokens, separated by spans of one or more _wwww_cccc_hhhh_aaaa_rrrr______tttt characters from the
  27.      separator _wwww_cccc_hhhh_aaaa_rrrr______tttt string _s_2.  The first call (with the pointer _s_1
  28.      specified) returns a pointer to the first _wwww_cccc_hhhh_aaaa_rrrr______tttt character of the first
  29.      token, and writes a _wwww_cccc_hhhh_aaaa_rrrr______tttt null character into _s_1 immediately following
  30.      the returned token.  The function keeps track of its position in the
  31.      _wwww_cccc_hhhh_aaaa_rrrr______tttt string between separate calls, so that subsequent calls (which
  32.      must be made with the first argument a null pointer) will progress
  33.      through the _wwww_cccc_hhhh_aaaa_rrrr______tttt string _s_1 immediately following that token.
  34.      Similarly, subsequent calls will progress through the _wwww_cccc_hhhh_aaaa_rrrr______tttt string _s_1
  35.      until no tokens remain.  The _wwww_cccc_hhhh_aaaa_rrrr______tttt separator string _s_2 may be different
  36.      from call to call.  A null pointer is returned when no token remains in
  37.      _s_1.
  38.  
  39.      _ssss_tttt_rrrr_tttt_oooo_wwww_ssss transforms EUC in character string _s_2 into _wwww_cccc_hhhh_aaaa_rrrr______tttt characters,
  40.      and transfers those to _wwww_cccc_hhhh_aaaa_rrrr______tttt string _s_1, stopping after the null
  41.      character has been processed.
  42.  
  43. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  44.      _mmmm_aaaa_llll_llll_oooo_cccc(3C), _wwww_iiii_dddd_eeee_cccc(3S), _wwww_cccc_ssss_tttt_rrrr_iiii_nnnn_gggg(3S), _mmmm_aaaa_llll_llll_oooo_cccc(3X).
  45.  
  46. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  47.      On success, _ssss_tttt_rrrr_tttt_oooo_wwww_ssss returns _s_1.  If an illegal byte sequence is detected,
  48.      a null pointer is returned and _eeee_rrrr_rrrr_nnnn_oooo is set to _EEEE_IIII_LLLL_SSSS_EEEE_QQQQ.
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.                                                                         PPPPaaaaggggeeee 1111
  61.  
  62.  
  63.  
  64.