draft/man3/getw.3

   1 .\" Copyright (c) 1995 by Jim Van Zandt <jrv@vanzandt.mv.com>
   2 .\"
   3 .\" Japanese Version Copyright (c) 1997 HIROFUMI Nishizuka
   4 .\"     all rights reserved.
   5 .\" Translated Wed Dec 24 12:33:19 JST 1997
   6 .\"     by HIROFUMI Nishizuka <nishi@rpts.cl.nec.co.jp>
   7 .\" Updated Sun Jun 18 16:38:02 JST 2000
   8 .\"     by Kentaro Shirakata <argrath@ub32.org>
   9 .\"
  10 .\" Permission is granted to make and distribute verbatim copies of this
  11 .\" manual provided the copyright notice and this permission notice are
  12 .\" preserved on all copies.
  13 .\"
  14 .\" Permission is granted to copy and distribute modified versions of this
  15 .\" manual under the conditions for verbatim copying, provided that the
  16 .\" entire resulting derived work is distributed under the terms of a
  17 .\" permission notice identical to this one.
  18 .\"
  19 .\" Since the Linux kernel and libraries are constantly changing, this
  20 .\" manual page may be incorrect or out-of-date.  The author(s) assume no
  21 .\" responsibility for errors or omissions, or for damages resulting from
  22 .\" the use of the information contained herein.  The author(s) may not
  23 .\" have taken the same level of care in the production of this manual,
  24 .\" which is licensed free of charge, as they might when working
  25 .\" professionally.
  26 .\"
  27 .\" Formatted or processed versions of this manual, if unaccompanied by
  28 .\" the source, must acknowledge the copyright and authors of this work.
  29 .\" License.
  30 .TH GETW 3  2010-09-26 "GNU" "Linux Programmer's Manual"
  31 .\"O .SH NAME
  32 .SH 名前
  33 .\"O getw, putw \- input and output of words (ints)
  34 getw, putw \- ワード(int)の入出力
  35 .\"O .SH SYNOPSIS
  36 .SH 書式
  37 .nf
  38 .B #include <stdio.h>
  39 .sp
  40 .BI "int getw(FILE *" stream );
  41
  42 .BI "int putw(int " w ", FILE *" stream );
  43 .fi
  44 .sp
  45 .in -4n
  46 .\"O Feature Test Macro Requirements for glibc (see
  47 .\"O .BR feature_test_macros (7)):
  48 glibc 向けの機能検査マクロの要件
  49 .RB ( feature_test_macros (7)
  50 参照):
  51 .in
  52 .sp
  53 .BR getw (),
  54 .BR putw ():
  55 .ad l
  56 .PD 0
  57 .RS 4
  58 .TP 4
  59 .\"O Since glibc 2.3.3:
  60 glibc 2.3.3 以降:
  61 _SVID_SOURCE || _BSD_SOURCE ||
  62 .br
  63 (_XOPEN_SOURCE &&
  64     !(_POSIX_C_SOURCE\ >=\ 200112L || _XOPEN_SOURCE\ >=\ 600))
  65 .TP
  66 .\"O Before glibc 2.3.3:
  67 glibc 2.3.3 より前:
  68 _SVID_SOURCE || _BSD_SOURCE || _XOPEN_SOURCE
  69 .RE
  70 .PD
  71 .ad
  72 .\"O .SH DESCRIPTION
  73 .SH 説明
  74 .\"O .BR getw ()
  75 .\"O reads a word (that is, an \fIint\fP) from \fIstream\fP.
  76 .\"O It's provided for compatibility with SVr4.
  77 .\"O We recommend you use
  78 .\"O .BR fread (3)
  79 .\"O instead.
  80 .BR getw ()
  81 は \fIstream\fP からワード (\fIint\fP型) を読み込む。
  82 この関数は、SVr4 との互換性のために提供されている。
  83 この関数の代わりに
  84 .BR fread (3)
  85 を使用することを勧める。
  86 .P
  87 .\"O .BR putw ()
  88 .\"O writes the word \fIw\fP (that is,
  89 .\"O an \fIint\fP) to \fIstream\fP.
  90 .\"O It is provided for compatibility with SVr4, but we recommend you use
  91 .\"O .BR fwrite (3)
  92 .\"O instead.
  93 .BR putw ()
  94 は \fIstream\fP にワード \fIw\fP (\fIint\fP型) を書き込む。
  95 この関数は SVr4 との互換性のために提供されているが、この関数の代わりに
  96 .BR fwrite (3)
  97 を使用することを勧める。
  98 .\"O .SH "RETURN VALUES"
  99 .SH 返り値
 100 .\"O Normally,
 101 .\"O .BR getw ()
 102 .\"O returns the word read, and
 103 .\"O .BR putw ()
 104 .\"O returns 0.
 105 通常、
 106 .BR getw ()
 107 は読み込んだワードを返し、
 108 .BR putw ()
 109 は 0 を返す。
 110 .\"O On error, they return \fBEOF\fP.
 111 エラーが発生した場合、これらの関数は \fBEOF\fP を返す。
 112 .\"O .SH "CONFORMING TO"
 113 .SH 準拠
 114 .\"O SVr4, SUSv2.  Not present in POSIX.1-2001.
 115 SVr4, SUSv2.  POSIX.1-2001 には存在しない。
 116 .\"O .SH BUGS
 117 .SH バグ
 118 .\"O The value returned on error is also a legitimate data value.
 119 エラーの時に返される値は、正しいデータとして返されることもある。
 120 .\"O .BR ferror (3)
 121 .\"O can be used to distinguish between the two cases.
 122 .BR ferror (3)
 123 を用いると、この二つの場合を区別することが出来る。
 124 .\"O .SH "SEE ALSO"
 125 .SH 関連項目
 126 .BR ferror (3),
 127 .BR fread (3),
 128 .BR fwrite (3),
 129 .BR getc (3),
 130 .BR putc (3)