manual/LDP_man-pages/release/man3/iconv_open.3

   1 .\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
   2 .\"
   3 .\" This is free documentation; you can redistribute it and/or
   4 .\" modify it under the terms of the GNU General Public License as
   5 .\" published by the Free Software Foundation; either version 2 of
   6 .\" the License, or (at your option) any later version.
   7 .\"
   8 .\" References consulted:
   9 .\"   GNU glibc-2 source code and manual
  10 .\"   OpenGroup's Single Unix specification
  11 .\"     http://www.UNIX-systems.org/online.html
  12 .\"
  13 .\" 2007-03-31 Bruno Haible, Describe the glibc/libiconv //TRANSLIT
  14 .\" and //IGNORE extensions for 'tocode'.
  15 .\"
  16 .\" Japanese Version Copyright (c) 2000 Yuichi SATO
  17 .\"         all rights reserved.
  18 .\" Translated Tue Jul 11 19:02:58 JST 2000
  19 .\"         by Yuichi SATO <sato@complex.eng.hokudai.ac.jp>
  20 .\" Updated 2007-06-01, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>, LDP v2.50
  21 .\"
  22 .\"WORD:        allocate        ³ä¤êÅö¤Æ¤ë
  23 .\"WORD:        descriptor      ¥Ç¥£¥¹¥¯¥ê¥×¥¿
  24 .\"WORD:        conversion      ÊÑ´¹
  25 .\"WORD:        sequence        Ê¸»úÎó
  26 .\"
  27 .TH ICONV_OPEN 3  2008-08-11 "GNU" "Linux Programmer's Manual"
  28 .SH Ì¾Á°
  29 iconv_open \- Ê¸»ú¥»¥Ã¥ÈÊÑ´¹¤Î¤¿¤á¤Î¥Ç¥£¥¹¥¯¥ê¥×¥¿¤ò³ä¤êÅö¤Æ¤ë
  30 .SH ½ñ¼°
  31 .nf
  32 .B #include <iconv.h>
  33 .sp
  34 .BI "iconv_t iconv_open(const char *" tocode ", const char *" fromcode );
  35 .fi
  36 .SH ÀâÌÀ
  37 .BR iconv_open ()
  38 ´Ø¿ô¤Ï¡¢Ê¸»ú¥¨¥ó¥³¡¼¥Ç¥£¥ó¥° \fIfromcode\fP ¤«¤é
  39 Ê¸»ú¥¨¥ó¥³¡¼¥Ç¥£¥ó¥° \fItocode\fP ¤Ø¤Î¥Ð¥¤¥ÈÊ¸»úÎóÊÑ´¹¤ËÅ¬¤·¤¿
  40 ÊÑ´¹¥Ç¥£¥¹¥¯¥ê¥×¥¿¤ò³ä¤êÅö¤Æ¤ë¡£
  41 .PP
  42 \fIfromcode\fP ¤È \fItocode\fP ¤Ë»È¤¦¤³¤È¤Î¤Ç¤¤ëÃÍ¤È¡¢
  43 ¥µ¥Ý¡¼¥È¤µ¤ì¤ëÁÈ¤ß¹ç¤ï¤»¤Ï¡¢¥·¥¹¥Æ¥à¤Ë°ÍÂ¸¤¹¤ë¡£
  44 GNU C ¥é¥¤¥Ö¥é¥ê¤Ç¤Ï¡¢»È¤¦¤³¤È¤Î¤Ç¤¤ëÃÍ¤Ï
  45 \fBiconv \-\-list\fP ¥³¥Þ¥ó¥É¤Ç¥ê¥¹¥È¤µ¤ì¡¢
  46 ¥ê¥¹¥È¤µ¤ì¤¿¤¹¤Ù¤Æ¤ÎÃÍ¤ÎÁÈ¤ß¹ç¤ï¤»¤¬¥µ¥Ý¡¼¥È¤µ¤ì¤ë¡£
  47 ¤µ¤é¤Ë¡¢ GNU C ¥é¥¤¥Ö¥é¥ê¤È GNU libiconv ¥é¥¤¥Ö¥é¥ê¤Ç¤Ï¡¢
  48 °Ê²¼¤ÎÀÜÈø¼¤¬¥µ¥Ý¡¼¥È¤µ¤ì¤Æ¤¤¤ë¡£
  49 .TP
  50 //TRANSLIT
  51 \fItocode\fP ¤Î¸å¤í¤ËÊ¸»úÎó "//TRANSLIT" ¤¬ÉÕ¤¤¤Æ¤¤¤ë¾ì¹ç¡¢
  52 ËÝÌõ (transliteration) ¤¬Í¸ú¤Ë¤Ê¤ë¡£¤³¤Î¾ì¹ç¡¢
  53 ÊÑ´¹Àè¤ÎÊ¸»ú¥»¥Ã¥È¤ÇÉ½¸½¤Ç¤¤Ê¤¤Ê¸»ú¤ò¡¢¤½¤ÎÊ¸»ú¤ÈÆ±¤¸¤è¤¦¤Ë¸«¤¨¤ë
  54 Ê¸»ú (Ê£¿ôÊ¸»ú¤Î¾ì¹ç¤â¤¢¤ë) ¤ÇÉ½¸½¤¹¤ë¤³¤È¤¬¤Ç¤¤ë¡£
  55 .TP
  56 //IGNORE
  57 \fItocode\fP ¤Î¸å¤í¤ËÊ¸»úÎó "//IGNORE" ¤¬ÉÕ¤¤¤Æ¤¤¤ë¾ì¹ç¡¢
  58 ÊÑ´¹Àè¤ÎÊ¸»ú¥»¥Ã¥È¤ÇÉ½¸½¤Ç¤¤Ê¤¤Ê¸»ú¤ÏÌÛ¤Ã¤ÆÌµ»ë¤µ¤ì¤ë¡£
  59 .PP
  60 ¤³¤Î´Ø¿ô¤òÆÉ¤ó¤ÇÆÀ¤é¤ì¤¿ÊÑ´¹¥Ç¥£¥¹¥¯¥ê¥×¥¿¤Ï¡¢
  61 .BR iconv (3)
  62 ¤Ç
  63 ²¿ÅÙ¤Ç¤â»È¤¦¤³¤È¤¬¤Ç¤¤ë¡£
  64 ¤³¤ì¤Ï
  65 .BR iconv_close (3)
  66 ¤ò»È¤Ã¤Æ²òÊü¤µ¤ì¤ë¤Þ¤ÇÍ¸ú¤Ç¤¢¤ë¡£
  67 .PP
  68 ÊÑ´¹¥Ç¥£¥¹¥¯¥ê¥×¥¿¤ÏÊÑ´¹¾õÂÖ¤ò»ý¤Ä¡£
  69 .BR iconv_open ()
  70 ¤òÍÑ¤¤¤ÆÀ¸À®¤µ¤ì¤¿¸å¡¢ÊÑ´¹¾õÂÖ¤Ï½é´ü¾õÂÖ¤Ç¤¢¤ë¡£
  71 .BR iconv (3)
  72 ¤ò»È¤¦¤³¤È¤Ë¤è¤ê¡¢¥Ç¥£¥¹¥¯¥ê¥×¥¿¤ÎÊÑ´¹¾õÂÖ¤¬ÊÑ¹¹¤µ¤ì¤ë¡£
  73 (ÊÑ´¹¥Ç¥£¥¹¥¯¥ê¥×¥¿¤Ï¥Þ¥ë¥Á¥¹¥ì¥Ã¥É¤Ç
  74 Æ±»þ¤Ë»È¤¦¤³¤È¤¬¤Ç¤¤Ê¤¤¤³¤È¤ò°ÕÌ£¤·¤Æ¤¤¤ë¡£)
  75 ÊÑ´¹¾õÂÖ¤ò½é´ü¾õÂÖ¤ËÌá¤¹¤Ë¤Ï¡¢
  76 \fIinbuf\fP °ú¤¿ô¤ò NULL ¤È¤·¤Æ
  77 .BR iconv (3)
  78 ¤òÍÑ¤¤¤ë¤³¤È¡£
  79 .SH ÊÖ¤êÃÍ
  80 .BR iconv_open ()
  81 ´Ø¿ô¤Ï¡¢¿·¤¿¤Ë³ä¤êÅö¤Æ¤é¤ì¤¿ÊÑ´¹¥Ç¥£¥¹¥¯¥ê¥×¥¿¤òÊÖ¤¹¡£
  82 ¥¨¥é¡¼¤Î¾ì¹ç¡¢¤³¤Î´Ø¿ô¤Ï \fIerrno\fP ¤òÀßÄê¤·¡¢
  83 .I (iconv_t)\ \-1
  84 ¤òÊÖ¤¹¡£
  85 .SH ¥¨¥é¡¼
  86 Â¾¤Î¤¤¤í¤¤¤í¤Ê¥¨¥é¡¼¤Î¤¦¤Á¡¢°Ê²¼¤Î¥¨¥é¡¼¤¬µ¯¤³¤ê¤¦¤ë¡£
  87 .TP
  88 .B EINVAL
  89 \fIfromcode\fP ¤«¤é \fItocode\fP ¤Ø¤ÎÊÑ´¹¤Ï¡¢¤³¤Î¼ÂÁõ¤Ç¤Ï¥µ¥Ý¡¼¥È¤µ¤ì¤Æ¤¤¤Ê¤¤¡£
  90 .SH ¥Ð¡¼¥¸¥ç¥ó
  91 ¤³¤Î´Ø¿ô¤Ï¥Ð¡¼¥¸¥ç¥ó 2.1 °Ê¹ß¤Î glibc ¤ÇÍøÍÑ²ÄÇ½¤Ç¤¢¤ë¡£
  92 .SH ½àµò
  93 UNIX98, POSIX.1-2001.
  94 .SH ´ØÏ¢¹àÌÜ
  95 .BR iconv (1),
  96 .BR iconv (3),
  97 .BR iconv_close (3)