release/man3/wcstombs.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 .\"   ISO/IEC 9899:1999
  13 .\"
  14 .\" Japanese Version Copyright (c) 1999 HANATAKA Shinya
  15 .\"         all rights reserved.
  16 .\" Translated Tue Jan 11 00:55:41 JST 2000
  17 .\"         by HANATAKA Shinya <hanataka@abyss.rim.or.jp>
  18 .\"
  19 .TH WCSTOMBS 3  1999-07-25 "GNU" "Linux Programmer's Manual"
  20 .SH Ì¾Á°
  21 wcstombs \- ¥ï¥¤¥ÉÊ¸»úÎó¤ò¥Þ¥ë¥Á¥Ð¥¤¥ÈÊ¸»úÎó¤ËÊÑ´¹¤¹¤ë
  22 .SH ½ñ¼°
  23 .nf
  24 .B #include <stdlib.h>
  25 .sp
  26 .BI "size_t wcstombs(char *" dest ", const wchar_t *" src ", size_t " n );
  27 .fi
  28 .SH ÀâÌÀ
  29 \fIdest\fP ¤¬ NULL ¥Ý¥¤¥ó¥¿¤Ç¤Ê¤¤¾ì¹ç¡¢
  30 .BR wcstombs ()
  31 ´Ø¿ô¤Ï
  32 ¥ï¥¤¥ÉÊ¸»úÎó \fIsrc\fP ¤ò \fIdest\fP ¤«¤é»Ï¤Þ¤ë¥Þ¥ë¥Á¥Ð¥¤¥ÈÊ¸»úÎó¤Ë
  33 ÊÑ´¹¤¹¤ë¡£\fIdest\fP ¤Ë¤ÏºÇÂç¤Ç \fIn\fP ¥Ð¥¤¥È¤¬½ñ¤¹þ¤Þ¤ì¤ë¡£
  34 ÊÑ´¹¤Ï½é´ü¾õÂÖ¤Ç³«»Ï¤µ¤ì¤ë¡£ÊÑ´¹¤Ï°Ê²¼¤Î3¤Ä¤ÎÍýÍ³¤Ë¤è¤êÄä»ß¤¹¤ë¡£
  35 .PP
  36 1. (¸½ºß¤Î¥í¥±¡¼¥ë¤Ë¤ª¤±¤ë)¥Þ¥ë¥Á¥Ð¥¤¥ÈÎó¤ÇÉ½¸½¤Ç¤¤Ê¤¤¥ï¥¤¥ÉÊ¸»ú¤Ë
  37 Áø¶ø¤·¤¿¾ì¹ç¡£¤³¤Î¾ì¹ç¤Ë¤Ï
  38 .I (size_t)\ \-1
  39 ¤¬ÊÖ¤µ¤ì¤ë¡£
  40 .PP
  41 2. Ä¹¤µÀ©¸Â¤Ë¤è¤Ã¤Æ¶¯À©Ää»ß¤µ¤»¤é¤ì¤¿¾ì¹ç¡£¤³¤Î¾ì¹ç¤Ë¤Ï \fIdest\fP ¤Ë
  42 ½ñ¤¹þ¤Þ¤ì¤¿¥Ð¥¤¥È¿ô¤¬ÊÖ¤µ¤ì¤ë¡£¤·¤«¤·¤³¤Î»þÅÀ¤Ç¤Î¥·¥Õ¥È¾õÂÖ¤Ï¼º¤ï¤ì¤ë¡£
  43 .PP
  44 3. ¥ï¥¤¥ÉÊ¸»úÎó¤¬½ªÃ¼¤Î L\(aq\\0\(aq ¤ò´Þ¤á¤Æ´°Á´¤ËÊÑ´¹¤µ¤ì¤¿¾ì¹ç¡£
  45 ¤³¤Î¾ì¹ç¤Ë¤ÏÊÑ´¹¤Ï½é´ü¾õÂÖ¤Ç½ª¤ê¡¢½ªÃ¼¤Î \(aq\\0\(aq ¥Ð¥¤¥È¤ò½ü¤¤¤Æ
  46 \fIdest\fP ¤Ë½ñ¤¹þ¤Þ¤ì¤¿¥Ð¥¤¥È¿ô¤òÊÖ¤¹¡£
  47 .PP
  48 ¥×¥í¥°¥é¥Þ¡¼¤Ï \fIdest\fP ¤ËºÇÄã¤Ç¤â \fIn\fP ¥Ð¥¤¥È¤Î¶õ¤¤¬¤¢¤ë¤³¤È¤ò
  49 ÊÝ¾Ú¤·¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¡£
  50 .PP
  51 \fIdest\fP ¤¬ NULL ¤Î¾ì¹ç¡¢\fIn\fP ¤ÏÌµ»ë¤µ¤ì¤ë¡£¾åµ¤ÈÆ±ÍÍ¤ËÊÑ´¹¤¬¹Ô
  52 ¤Ê¤ï¤ì¤ë¤¬ÊÑ´¹·ë²Ì¤Î¥Ð¥¤¥ÈÎó¤Ï¥á¥â¥ê¤Ë¤Ï½ñ¤¹þ¤Þ¤ì¤Ê¤¤¡£
  53 ¤Þ¤¿Ä¹¤µ¤Î¾å¸Â¤¬Â¸ºß¤·¤Ê¤¤¡£
  54 .PP
  55 ¾åµ¤Î 2. ¤Î¾ì¹ç¤òÈò¤±¤ë¤¿¤á¤Ë¡¢¥×¥í¥°¥é¥Þ¡¼¤Ï \fIn\fP ¤¬
  56 \fIwcstombs(NULL,src,0)+1\fP °Ê¾å¤Ç¤¢¤ë¤³¤È¤òÊÝ¾Ú¤·¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¡£
  57 .SH ÊÖ¤êÃÍ
  58 .BR wcstombs ()
  59 ´Ø¿ô¤ÏÀ¸À®¤·¤¿¥Þ¥ë¥Á¥Ð¥¤¥ÈÎó¤Î¥Ð¥¤¥È¿ô¤òÊÖ¤¹¡£½ªÃ¼¤Î
  60 ¥Ê¥ëÊ¸»ú¤Ï´Þ¤Þ¤Ê¤¤¡£¤â¤·ÊÑ´¹¤Ç¤¤Ê¤¤¥ï¥¤¥ÉÊ¸»ú¤ËÁø¶ø¤·¤¿¾ì¹ç¤Ë¤Ï
  61 .I (size_t)\ \-1
  62 ¤òÊÖ¤¹¡£
  63 .SH ½àµò
  64 C99.
  65 .SH Ãí°Õ
  66 .BR wcstombs ()
  67 ¤ÎÆ°ºî¤Ï¸½ºß¤Î¥í¥±¡¼¥ë¤Î
  68 .B LC_CTYPE
  69 ¥«¥Æ¥´¥ê¤Ë°ÍÂ¸¤·¤Æ¤¤¤ë¡£
  70 .PP
  71 .BR wcsrtombs ()
  72 ´Ø¿ô¤ÏÆ±¤¸µ¡Ç½¤Î¤¿¤á¤Î¥¹¥ì¥Ã¥É¡¦¥»¡¼¥Õ¤Ê
  73 ¥¤¥ó¥¿¡¼¥Õ¥§¡¼¥¹¤òÄó¶¡¤¹¤ë¡£
  74 .SH ´ØÏ¢¹àÌÜ
  75 .BR wcsrtombs (3)