manual/LDP_man-pages/draft/man3/puts.3

   1 .\" Copyright (c) 1993 by Thomas Koenig (ig25@rz.uni-karlsruhe.de)
   2 .\"
   3 .\" Permission is granted to make and distribute verbatim copies of this
   4 .\" manual provided the copyright notice and this permission notice are
   5 .\" preserved on all copies.
   6 .\"
   7 .\" Permission is granted to copy and distribute modified versions of this
   8 .\" manual under the conditions for verbatim copying, provided that the
   9 .\" entire resulting derived work is distributed under the terms of a
  10 .\" permission notice identical to this one.
  11 .\"
  12 .\" Since the Linux kernel and libraries are constantly changing, this
  13 .\" manual page may be incorrect or out-of-date.  The author(s) assume no
  14 .\" responsibility for errors or omissions, or for damages resulting from
  15 .\" the use of the information contained herein.  The author(s) may not
  16 .\" have taken the same level of care in the production of this manual,
  17 .\" which is licensed free of charge, as they might when working
  18 .\" professionally.
  19 .\"
  20 .\" Formatted or processed versions of this manual, if unaccompanied by
  21 .\" the source, must acknowledge the copyright and authors of this work.
  22 .\" License.
  23 .\" Modified Sat Jul 24 18:42:59 1993 by Rik Faith (faith@cs.unc.edu)
  24 .\"
  25 .\" Japanese Version Copyright (c) 1997 HIROFUMI Nishizuka
  26 .\"     all rights reserved.
  27 .\" Translated Wed Dec 24 12:33:40 JST 1997
  28 .\"     by HIROFUMI Nishizuka <nishi@rpts.cl.nec.co.jp>
  29 .\" Updated Fri Nov  2 JST 2001 by Kentaro Shirakata <argrath@ub32.org>
  30 .\"
  31 .TH PUTS 3  1993-04-04 "GNU" "Linux Programmer's Manual"
  32 .\"O .SH NAME
  33 .SH Ì¾Á°
  34 .\"O fputc, fputs, putc, putchar, puts \- output of characters and strings
  35 fputc, fputs, putc, putchar, puts \- Ê¸»ú¤ÈÊ¸»úÎó¤Î½ÐÎÏ
  36 .\"O .SH SYNOPSIS
  37 .SH ½ñ¼°
  38 .nf
  39 .B #include <stdio.h>
  40 .sp
  41 .BI "int fputc(int " c ", FILE *" stream );
  42
  43 .BI "int fputs(const char *" "s" ", FILE *" "stream" );
  44
  45 .BI "int putc(int " c ", FILE *" stream );
  46
  47 .BI "int putchar(int " c );
  48
  49 .BI "int puts(const char *" "s" );
  50 .fi
  51 .\"O .SH DESCRIPTION
  52 .SH ÀâÌÀ
  53 .\"O .BR fputc ()
  54 .\"O writes the character
  55 .\"O .IR c ,
  56 .\"O cast to an
  57 .\"O .IR "unsigned char" ,
  58 .\"O to
  59 .\"O .IR stream .
  60 .BR fputc ()
  61 ¤Ï¡¢¥¥ã¥é¥¯¥¿
  62 .I c
  63 ¤ò
  64 .I "unsigned char"
  65 ¤Ë¥¥ã¥¹¥È¤·¡¢
  66 .I stream
  67 ¤Ë½ñ¤¹þ¤à¡£
  68 .PP
  69 .\"O .BR fputs ()
  70 .\"O writes the string
  71 .\"O .I s
  72 .\"O to
  73 .\"O .IR stream ,
  74 .\"O without its trailing
  75 .\"O .BR \(aq\e0\(aq .
  76 .BR fputs ()
  77 ¤Ï¡¢Ê¸»úÎó
  78 .I s
  79 ¤ò
  80 .I stream
  81 ¤Ë½ñ¤¹þ¤à¡£
  82 Ê¸»úÎó¤ËÂ³¤¯
  83 .B \(aq\e0\(aq
  84 ¤Ï½ÐÎÏ¤·¤Ê¤¤¡£
  85 .PP
  86 .\"O .BR putc ()
  87 .\"O is equivalent to
  88 .\"O .BR fputc ()
  89 .\"O except that it may be implemented as a macro which evaluates
  90 .\"O .I stream
  91 .\"O more than once.
  92 .BR putc ()
  93 ¤Ï¡¢
  94 .I stream
  95 ¤ò°ìÅÙ°Ê¾åÉ¾²Á¤¹¤ë¥Þ¥¯¥í¤È¤·¤Æ¼ÂÁõ¤µ¤ì¤Æ¤¤¤ë¤«¤âÃÎ¤ì¤Ê¤¤¤È¤¤¤¦ÅÀ¤ò½ü¤¡¢
  96 .BR fputc ()
  97 ¤ÈÆ±¤¸¤Ç¤¢¤ë¡£
  98 .PP
  99 .\"O .BI "putchar(" c );
 100 .\"O is equivalent to
 101 .\"O .BI "putc(" c , stdout ).
 102 .BI "putchar(" c );
 103 ¤Ï¡¢
 104 .BI "putc(" c , stdout )
 105 ¤ÈÆ±¤¸¤Ç¤¢¤ë¡£
 106 .PP
 107 .\"O .BR puts ()
 108 .\"O writes the string
 109 .\"O .I s
 110 .\"O and a trailing newline
 111 .\"O to
 112 .\"O .IR stdout .
 113 .BR puts ()
 114 ¤Ï¡¢Ê¸»úÎó
 115 .I s
 116 ¤È²þ¹Ô¤ò
 117 .I stdout
 118 ¤Ë½ñ¤¹þ¤à¡£
 119 .PP
 120 .\"O Calls to the functions described here can be mixed with each other and with
 121 .\"O calls to other output functions from the
 122 .\"O .I stdio
 123 .\"O library for the same output stream.
 124 ¤³¤³¤ÇÀâÌÀ¤µ¤ì¤¿´Ø¿ô¤Ï¤ª¸ß¤¤¤Ëº®ºß¤·¤Æ»ÈÍÑ¤¹¤ë¤³¤È¤¬¤Ç¤¡¢¤Þ¤¿¡¢
 125 .I stdio
 126 ¥é¥¤¥Ö¥é¥ê¤Ë´Þ¤Þ¤ì¤ëÂ¾¤Î½ÐÎÏ´Ø¿ô¤òÆ±¤¸½ÐÎÏ¥¹¥È¥ê¡¼¥à¤ËÂÐ¤·¤Æ
 127 ¸Æ¤Ó½Ð¤¹»ö¤¬½ÐÍè¤ë¡£
 128 .PP
 129 .\"O For nonlocking counterparts, see
 130 .\"O .BR unlocked_stdio (3).
 131 ¤³¤ì¤é¤Î½èÍý¤ò¥í¥Ã¥¯¤»¤º¤Ë¹Ô¤¤¤¿¤¤¤È¤¤Ï¡¢
 132 .BR unlocked_stdio (3)
 133 ¤ò»²¾È¤Î¤³¤È¡£
 134 .\"O .SH "RETURN VALUE"
 135 .SH ÊÖ¤êÃÍ
 136 .\"O .BR fputc (),
 137 .\"O .BR putc ()
 138 .\"O and
 139 .\"O .BR putchar ()
 140 .\"O return the character written as an
 141 .\"O .I unsigned char
 142 .\"O cast to an
 143 .\"O .I int
 144 .\"O or
 145 .\"O .B EOF
 146 .\"O on error.
 147 .BR fputc (),
 148 .BR putc (),
 149 .BR putchar ()
 150 ¤Ï
 151 .I unsigned char
 152 ¤È¤·¤Æ½ñ¤¹þ¤Þ¤ì¤¿Ê¸»ú¤ò
 153 .I int
 154 ¤Ë¥¥ã¥¹¥È¤·¤ÆÊÖ¤¹¡£
 155 ¥¨¥é¡¼¤¬È¯À¸¤·¤¿¾ì¹ç¤Ï
 156 .B EOF
 157 ¤òÊÖ¤¹¡£
 158 .PP
 159 .\"O .BR puts ()
 160 .\"O and
 161 .\"O .BR fputs ()
 162 .\"O return a nonnegative number on success, or
 163 .\"O .B EOF
 164 .\"O on error.
 165 .BR puts ()
 166 ¤È
 167 .BR fputs ()
 168 ¤Ï¡¢À®¸ù¤¹¤ë¤ÈÉé¤Ç¤Ï¤Ê¤¤¿ô¤ò¡¢¥¨¥é¡¼¤¬È¯À¸¤·¤¿¾ì¹ç¤Ï
 169 .B EOF
 170 ¤òÊÖ¤¹¡£
 171 .\"O .SH "CONFORMING TO"
 172 .SH ½àµò
 173 C89, C99.
 174 .\"O .SH BUGS
 175 .SH ¥Ð¥°
 176 .\"O It is not advisable to mix calls to output functions from the
 177 .\"O .I stdio
 178 .\"O library with low-level calls to
 179 .\"O .BR write (2)
 180 .\"O for the file descriptor associated with the same output stream; the results
 181 .\"O will be undefined and very probably not what you want.
 182 .I stdio
 183 ¥é¥¤¥Ö¥é¥ê¤Ë´Þ¤Þ¤ì¤ë½ÐÎÏ´Ø¿ô¤È¡¢Æ±¤¸½ÐÎÏ¥¹¥È¥ê¡¼¥à¤Ë·ë¤Ó¤Ä¤±¤é¤ì¤¿
 184 ¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤ËÂÐ¤¹¤ë
 185 .BR write (2)
 186 ¤ÎÄã¥ì¥Ù¥ë¸Æ¤Ó½Ð¤·¤òº®ºß¤·¤Æ
 187 »ÈÍÑ¤¹¤ë¤³¤È¤Ï¸ÌÀ¤Ç¤Ï¤Ê¤¤¡£
 188 ¤½¤Î·ë²Ì¤ÏÄêµÁ¤µ¤ì¤Æ¤ª¤é¤º¡¢Ë¾¤à·ë²Ì¤¬ÆÀ¤é¤ì¤Ê¤¤²ÄÇ½À¤¬¹â¤¤¡£
 189 .\"O .SH "SEE ALSO"
 190 .SH ´ØÏ¢¹àÌÜ
 191 .BR write (2),
 192 .BR ferror (3),
 193 .BR fopen (3),
 194 .BR fputwc (3),
 195 .BR fputws (3),
 196 .BR fseek (3),
 197 .BR fwrite (3),
 198 .BR gets (3),
 199 .BR putwchar (3),
 200 .BR scanf (3),
 201 .BR unlocked_stdio (3)