release/man3/wcsnrtombs.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 .\"   Dinkumware C library reference http://www.dinkumware.com/
  11 .\"   OpenGroup's Single Unix specification http://www.UNIX-systems.org/online.html
  12 .\"
  13 .\" About this Japanese page, please contact to JM Project <JM@linux.or.jp>
  14 .\" Translated Fri Oct 22 01:12:12 JST 1999
  15 .\"           by FUJIWARA Teruyoshi <fujiwara@linux.or.jp>
  16 .\"
  17 .TH WCSNRTOMBS 3  2007-07-26 "GNU" "Linux Programmer's Manual"
  18 .SH Ì¾Á°
  19 wcsnrtombs \- ¥ï¥¤¥ÉÊ¸»úÊ¸»úÎó¤ò¥Þ¥ë¥Á¥Ð¥¤¥ÈÊ¸»úÎó¤ËÊÑ´¹¤¹¤ë
  20 .SH ½ñ¼°
  21 .nf
  22 .B #define _GNU_SOURCE
  23 .B #include <wchar.h>
  24 .sp
  25 .BI "size_t wcsnrtombs(char *" dest ", const wchar_t **" src ", size_t " nwc ,
  26 .BI "                  size_t " len ", mbstate_t *" ps );
  27 .fi
  28 .SH ÀâÌÀ
  29 .BR wcsnrtombs ()
  30 ´Ø¿ô¤Ï¡¢
  31 .BR wcsrtombs ()
  32 ´Ø¿ô¤Ë»÷¤Æ¤¤¤ë¡£¤¿¤À¤·¡¢
  33 ÊÑ´¹¤µ¤ì¤ë¥ï¥¤¥ÉÊ¸»ú¤Î¿ô¤¬(\fI*src\fP ¤«¤é¿ô¤¨¤Æ) \fInwc\fP Ê¸»ú¤ËÀ©¸Â
  34 ¤µ¤ì¤Æ¤¤¤ëÅÀ¤¬°Û¤Ê¤ë¡£
  35 .PP
  36 \fIdest\fP ¤¬ NULL ¥Ý¥¤¥ó¥¿¤Ç¤Ê¤±¤ì¤Ð¡¢
  37 .BR wcsnrtombs ()
  38 ´Ø¿ô¤Ï
  39 ¥ï¥¤¥ÉÊ¸»úÊ¸»úÎó¤ÎºÇÂç \fInwc\fP ¸Ä¤Þ¤Ç¤Î¥ï¥¤¥ÉÊ¸»ú¤ò \fIdest\fP ¤«¤é
  40 »Ï¤Þ¤ë¥Þ¥ë¥Á¥Ð¥¤¥ÈÊ¸»úÎó¤ËÊÑ´¹¤¹¤ë¡£\fIdest\fP ¤Ë¤ÏºÇÂç \fIlen\fP ¥Ð¥¤
  41 ¥È¤Þ¤Ç½ñ¤¹þ¤Þ¤ì¤ë¡£¥·¥Õ¥È¾õÂÖ \fI*ps\fP ¤Ï¹¹¿·¤µ¤ì¤ë¡£¼ÂºÝ¤Î¸ú²Ì¤È¤·
  42 ¤Æ¤Ï¡¢¤³¤ÎÊÑ´¹¤Ï°Ê²¼¤ÎÆ°ºî¤ÈÆ±¤¸¤Ë¤Ê¤ë:
  43 .IR "wcrtomb(dest, *src, ps)"
  44 ¤ò¸Æ¤Ó¡¢À®¸ù¤¬ÊÖ¤Ã¤¿¤é
  45 \fIdest\fP ¤ò½ñ¤¹þ¤ó¤À¥Ð¥¤¥È¿ô¤À¤±Áý¤ä¤·¡¢\fI*src\fP ¤ò 1 Áý¤ä¤¹¡£
  46 ¤½¤·¤Æ¡¢wcrtomb ¤¬À®¸ù¤òÊÖ¤¹¸Â¤ê¤³¤ì¤ò·«¤êÊÖ¤¹¡£
  47 ÊÑ´¹¤¬»ß¤Þ¤ëÍýÍ³¤Ï 3 ¤Ä¹Í¤¨¤é¤ì¤ë:
  48 .PP
  49 1. (¸½ºß¤Î¥í¥±¡¼¥ë¤Ë´ð¤Å¤¤¤Æ)¥Þ¥ë¥Á¥Ð¥¤¥ÈÎó¤ÇÉ½¸½¤Ç¤¤Ê¤¤¥ï¥¤¥ÉÊ¸»ú¤Ë
  50 ½Ð²ñ¤Ã¤¿¾ì¹ç¡£¤³¤Î¾ì¹ç¤Ï¡¢\fI*src\fP ¤ÏÉÔÀµ¤Ê¥ï¥¤¥ÉÊ¸»ú¤ò»Ø¤·¤¿¾õÂÖ¤Ë¤Ê¤ê¡¢
  51 .I (size_t)\ \-1
  52 ¤¬ÊÖ¤µ¤ì¡¢\fIerrno\fP ¤Ë \fBEILSEQ\fP ¤¬ÀßÄê¤µ¤ì¤ë¡£
  53 .PP
  54 2. L\(aq\\0\(aq ¤Ë½Ð²ñ¤ï¤Ê¤¤¤Ç \fInwc\fP ¸Ä¤Î¥ï¥¤¥ÉÊ¸»ú¤òÊÑ´¹¤·¤¿¾ì¹ç¤«¡¢Ä¹
  55 ¤µ¤ÎÀ©¸Â¤Ë¤è¤Ã¤ÆÊÑ´¹¤¬»ß¤á¤é¤ì¤¿¾ì¹ç¡£¤³¤Î¾ì¹ç¤Ë¤Ï¡¢\fI*src\fP ¤Ï¼¡¤Ë
  56 ÊÑ´¹¤µ¤ì¤ë¤Ù¤¥ï¥¤¥ÉÊ¸»ú¤ò»Ø¤·¤¿¾õÂÖ¤Ë¤Ê¤ê¡¢\fIdest\fP ¤Ë½ñ¤¹þ¤Þ¤ì¤¿
  57 ¥Ð¥¤¥È¿ô¤¬ÊÖ¤µ¤ì¤ë¡£
  58 .PP
  59 3. ¥ï¥¤¥ÉÊ¸»úÎó¤¬½ªÃ¼¤Î L\(aq\\0\(aq (¤³¤ì¤Ë¤Ï \fI*ps\fP ¤ò½é´ü¾õÂÖ¤ËÌá¤¹¤È
  60 ¤¤¤¦ÉûºîÍÑ¤¬¤¢¤ë)¤â´Þ¤á¤ÆÁ´¤ÆÊÑ´¹¤µ¤ì¤¿¾ì¹ç¡£¤³¤Î¾ì¹ç¤Ë¤Ï \fI*src\fP
  61 ¤Ë NULL ¤¬ÀßÄê¤µ¤ì¡¢\fIdest\fP ¤Ë½ñ¤¹þ¤Þ¤ì¤¿¥Ð¥¤¥È¿ô¤¬ÊÖ¤µ¤ì¤ë
  62 (½ªÃ¼¤Î \(aq\\0\(aq ¤Ï¿ô¤¨¤Ê¤¤)¡£
  63 .PP
  64 \fIdest\fP ¤¬ NULL ¤Ê¤é¤Ð \fIlen\fP ¤ÏÌµ»ë¤µ¤ì¤ÆÁ°½Ò¤Î¤è¤¦¤ËÊÑ´¹¤¬¹Ô¤ï
  65 ¤ì¤ë¤¬¡¢ÊÑ´¹¤µ¤ì¤¿¥Ð¥¤¥È¥Ç¡¼¥¿¤Ï¥á¥â¥ê¤Ë½ñ¤½Ð¤µ¤ì¤Ê¤¤ÅÀ¤È¡¢½ÐÎÏÀè¤ÎÄ¹
  66 ¤µ¤ÎÀ©¸Â¤¬¤Ê¤¤ÅÀ¤¬°Û¤Ê¤ë¡£
  67 .PP
  68 ¾åµ¤Î¤¤¤º¤ì¤Î¾ì¹ç¤â¡¢\fIps\fP ¤¬ NULL ¥Ý¥¤¥ó¥¿¤Ê¤é¤Ð¡¢wcsnrtombs ´Ø¿ô
  69 ¤À¤±¤¬ÃÎ¤Ã¤Æ¤¤¤ëÀÅÅª¤ÊÆ¿Ì¾¤Î¾õÂÖ¤¬¥·¥Õ¥È¾õÂÖ¤ÎÂå¤ï¤ê¤ËÍÑ¤¤¤é¤ì¤ë¡£
  70 .PP
  71 ¥×¥í¥°¥é¥Þ¤Ï¾¯¤Ê¤¯¤È¤â \fIlen\fP ¥Ð¥¤¥È¤ÎÎÎ°è¤ò \fIdest\fP ¤Ë³ÎÊÝ¤·¤Ê
  72 ¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¡£
  73 .SH ÊÖ¤êÃÍ
  74 .BR wcsnrtombs ()
  75 ´Ø¿ô¤Ï¡¢ÊÑ´¹¤·¤ÆÆÀ¤é¤ì¤¿¥Þ¥ë¥Á¥Ð¥¤¥ÈÎó¤Î¥Ð¥¤¥È¿ô¤òÊÖ
  76 ¤¹¡£¤³¤ì¤Ë¤Ï½ªÃ¼¤Î null ¥Ð¥¤¥È¤Ï´Þ¤Þ¤Ê¤¤¡£
  77 ÊÑ´¹¤Ç¤¤Ê¤¤¥ï¥¤¥ÉÊ¸»ú¤Ë½Ð²ñ¤Ã¤¿¾ì¹ç¤Ë¤Ï
  78 .I (size_t)\ \-1
  79 ¤¬ÊÖ¤µ¤ì¡¢ \fIerrno\fP ¤Ë \fBEILSEQ\fP ¤¬ÀßÄê¤µ¤ì¤ë¡£
  80 .SH ½àµò
  81 ¤³¤Î´Ø¿ô¤Ï GNU ³ÈÄ¥¤Ç¤¢¤ë¡£
  82 .SH Ãí°Õ
  83 .BR wcsnrtombs ()
  84 ¤ÎÆ°ºî¤Ï¸½ºß¤Î¥í¥±¡¼¥ë¤Î
  85 .B LC_CTYPE
  86 ¥«¥Æ¥´¥ê¤Ë°ÍÂ¸¤¹¤ë¡£
  87 .PP
  88 \fIps\fP ¤Ë NULL ¤òÅÏ¤·¤¿ºÝ¤ÎÆ°ºî¤Ï¥Þ¥ë¥Á¥¹¥ì¥Ã¥É¥»¡¼¥Õ¤Ç¤Ê¤¤¡£
  89 .SH ´ØÏ¢¹àÌÜ
  90 .BR iconv (3),
  91 .BR wcsrtombs (3)