home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3c / wcsftime.z / wcsftime
Encoding:
Text File  |  2002-10-03  |  5.5 KB  |  67 lines
  1.  
  2.  
  3.  
  4. wwwwccccssssffffttttiiiimmmmeeee((((3333CCCC))))                                                      wwwwccccssssffffttttiiiimmmmeeee((((3333CCCC))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _wwww_cccc_ssss_ffff_tttt_iiii_mmmm_eeee - convert date and time to wide character string
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_wwww_cccc_hhhh_aaaa_rrrr_...._hhhh_>>>>
  13.  
  14.      XPG4
  15.      _ssss_iiii_zzzz_eeee______tttt _wwww_cccc_ssss_ffff_tttt_iiii_mmmm_eeee _((((_cccc_hhhh_aaaa_rrrr _****_wwww_cccc_ssss_,,,, _ssss_iiii_zzzz_eeee______tttt _mmmm_aaaa_xxxx_ssss_iiii_zzzz_eeee_,,,, _cccc_oooo_nnnn_ssss_tttt _cccc_hhhh_aaaa_rrrr _****_ffff_oooo_rrrr_mmmm_aaaa_tttt_,,,,
  16.          _cccc_oooo_nnnn_ssss_tttt _ssss_tttt_rrrr_uuuu_cccc_tttt _tttt_mmmm _****_tttt_iiii_mmmm_eeee_pppp_tttt_rrrr_))))_;;;;
  17.      XPG5
  18.      _ssss_iiii_zzzz_eeee______tttt _wwww_cccc_ssss_ffff_tttt_iiii_mmmm_eeee _((((_cccc_hhhh_aaaa_rrrr _****_wwww_cccc_ssss_,,,, _ssss_iiii_zzzz_eeee______tttt _mmmm_aaaa_xxxx_ssss_iiii_zzzz_eeee_,,,, _cccc_oooo_nnnn_ssss_tttt _wwww_cccc_hhhh_aaaa_rrrr______tttt _****_ffff_oooo_rrrr_mmmm_aaaa_tttt_,,,,
  19.          _cccc_oooo_nnnn_ssss_tttt _ssss_tttt_rrrr_uuuu_cccc_tttt _tttt_mmmm _****_tttt_iiii_mmmm_eeee_pppp_tttt_rrrr_))))_;;;;
  20.  
  21. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  22.      _wwww_cccc_ssss_ffff_tttt_iiii_mmmm_eeee places wide-character codes into the array pointed to by _w_c_s as
  23.      controlled by the string or the wide character string pointed to by
  24.      _f_o_r_m_a_t.  The _f_o_r_m_a_t string or wide character string consists of zero or
  25.      more directives and ordinary characters.  All ordinary characters
  26.      (including the terminating null character) are copied unchanged into the
  27.      array.  For _wwww_cccc_ssss_ffff_tttt_iiii_mmmm_eeee, no more than _m_a_x_s_i_z_e characters are placed into the
  28.      array.
  29.  
  30.      This function behaves as if the character string generated by _ssss_tttt_rrrr_ffff_tttt_iiii_mmmm_eeee is
  31.      passed to _mmmm_bbbb_ssss_tttt_oooo_wwww_cccc_ssss as the character string argument, and _mmmm_bbbb_ssss_tttt_oooo_wwww_cccc_ssss places
  32.      the result in the wide character string argument of _wwww_cccc_ssss_ffff_tttt_iiii_mmmm_eeee up to a
  33.      limit of _m_a_x_s_i_z_e wide-character codes.
  34.  
  35. RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  36.      If the total number of resulting wide character codes including the
  37.      terminating null wide-character code is no more than _m_a_x_s_i_z_e , _wwww_cccc_ssss_ffff_tttt_iiii_mmmm_eeee
  38.      returns the number of wide-character codes placed into the array pointed
  39.      to by _w_c_s , not including the terminating null wide-character code.
  40.      Otherwise _0000 is returned and the contents of the array are indeterminate.
  41.      If the function is not implemented, _e_r_r_n_o will be set to indicate the
  42.      error.
  43.  
  44. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  45.      _ssss_tttt_rrrr_ffff_tttt_iiii_mmmm_eeee(3C), _ssss_tttt_rrrr_ffff_tttt_iiii_mmmm_eeee(4), _mmmm_bbbb_ssss_tttt_oooo_wwww_cccc_ssss(3C), _<<<<_wwww_cccc_hhhh_aaaa_rrrr_...._hhhh_>>>>.
  46.  
  47. NNNNOOOOTTTTEEEESSSS
  48.      There are two types of _wwww_cccc_ssss_ffff_tttt_iiii_mmmm_eeee functions in n32 and 64 bit C libraries
  49.      for IRIX 6.5.17 or later versions. One is XPG4 type which has been in C
  50.      library, and another is XPG5 type function. The difference is a third
  51.      argument type, which is _cccc_oooo_nnnn_ssss_tttt _cccc_hhhh_aaaa_rrrr _****_ffff_oooo_rrrr_mmmm_aaaa_tttt for XPG4 and _cccc_oooo_nnnn_ssss_tttt _wwww_cccc_hhhh_aaaa_rrrr______tttt
  52.      _****_ffff_oooo_rrrr_mmmm_aaaa_tttt for XPG5. Old programs calling _wwww_cccc_ssss_ffff_tttt_iiii_mmmm_eeee function have XPG4
  53.      behavior of the function for backward compatibility. When XPG5 behavior
  54.      is required, new programs must be compiled with the wchar.h header file.
  55.      When XPG4 behavior is required, new programs must be compiled with the
  56.      wchar.h header file and setting _XOPEN_SOURCE to 400.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.