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 / setcat.z / setcat
Encoding:
Text File  |  2002-10-03  |  3.2 KB  |  67 lines
  1.  
  2.  
  3.  
  4. sssseeeettttccccaaaatttt((((3333CCCC))))                                                          sssseeeettttccccaaaatttt((((3333CCCC))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _ssss_eeee_tttt_cccc_aaaa_tttt - define default catalog
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_pppp_ffff_mmmm_tttt_...._hhhh_>>>>
  13.  
  14.      _cccc_hhhh_aaaa_rrrr _****_ssss_eeee_tttt_cccc_aaaa_tttt_((((_cccc_oooo_nnnn_ssss_tttt _cccc_hhhh_aaaa_rrrr _****_c_a_t_a_l_o_g_))))_;;;;
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      The routine _ssss_eeee_tttt_cccc_aaaa_tttt defines the default message catalog to be used by
  18.      subsequent calls to _gggg_eeee_tttt_tttt_xxxx_tttt, _llll_ffff_mmmm_tttt, or _pppp_ffff_mmmm_tttt that do not explicitly specify
  19.      a message catalog.
  20.  
  21.      _c_a_t_a_l_o_g must be limited to 14 characters.  These characters must be
  22.      selected from a set of all characters values, excluding _\\\\_0000 (null) and the
  23.      ASCII codes for _//// (slash) and _:::: (colon).
  24.  
  25.      _ssss_eeee_tttt_cccc_aaaa_tttt assumes that the catalog exists.  No checking is done on the
  26.      argument.
  27.  
  28.      A null pointer passed as an argument will result in the return of a
  29.      pointer to the current default message catalog name.  A pointer to an
  30.      empty string passed as an argument will cancel the default catalog.
  31.  
  32.      If no default catalog is specified, or if _c_a_t_a_l_o_g is an invalid catalog
  33.      name, subsequent calls to _gggg_eeee_tttt_tttt_xxxx_tttt, _llll_ffff_mmmm_tttt, or _pppp_ffff_mmmm_tttt that do not explicitly
  34.      specify a catalog name will use _MMMM_eeee_ssss_ssss_aaaa_gggg_eeee _nnnn_oooo_tttt _ffff_oooo_uuuu_nnnn_dddd_!!!!_!!!!\_n as the default
  35.      string.
  36.  
  37. EEEEXXXXAAAAMMMMPPPPLLLLEEEE
  38.           setcat("test");
  39.           gettxt(":10", "hello world\n")
  40.  
  41. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  42.      _gggg_eeee_tttt_tttt_xxxx_tttt(3C), _llll_ffff_mmmm_tttt(3C), _pppp_ffff_mmmm_tttt(3C), _ssss_eeee_tttt_llll_oooo_cccc_aaaa_llll_eeee(3C), _eeee_nnnn_vvvv_iiii_rrrr_oooo_nnnn(5)
  43.  
  44. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  45.      Upon success, _ssss_eeee_tttt_cccc_aaaa_tttt_((((_)))) returns a pointer to the catalog name.  Upon
  46.      failure, _ssss_eeee_tttt_cccc_aaaa_tttt_((((_)))) returns a null pointer.
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.