draft/man3/ungetwc.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:43 JST 2000
  17 .\"         by HANATAKA Shinya <hanataka@abyss.rim.or.jp>
  18 .\"
  19 .TH UNGETWC 3 1999-09-19 "GNU" "Linux Programmer's Manual"
  20 .\"O .SH NAME
  21 .SH 名前
  22 .\"O ungetwc \- push back a wide character onto a FILE stream
  23 ungetwc \- ワイド文字を FILE ストリームへ戻す
  24 .\"O .SH SYNOPSIS
  25 .SH 書式
  26 .nf
  27 .B #include <wchar.h>
  28 .sp
  29 .BI "wint_t ungetwc(wint_t " wc ", FILE *" stream );
  30 .fi
  31 .\"O .SH DESCRIPTION
  32 .SH 説明
  33 .\"O The \fBungetwc\fP() function is the wide-character equivalent of the
  34 .\"O .BR ungetc (3)
  35 .\"O function.
  36 .\"O It pushes back a wide character onto \fIstream\fP and returns it.
  37 .BR ungetwc ()
  38 関数は
  39 .BR ungetc (3)
  40 関数のワイド文字版である。
  41 この関数はワイド文字を \fIstream\fP へ戻して、それを返す。
  42 .PP
  43 .\"O If \fIwc\fP is \fBWEOF\fP, it returns \fBWEOF\fP.
  44 .\"O If \fIwc\fP is an invalid wide character,
  45 .\"O it sets \fIerrno\fP to \fBEILSEQ\fP and returns \fBWEOF\fP.
  46 \fIwc\fP が \fBWEOF\fP の場合、 \fBWEOF\fP を返す。
  47 \fIwc\fP が不正なワイド文字の場合、
  48 \fIerrno\fP に \fBEILSEQ\fP を設定して \fBWEOF\fP を返す。
  49 .PP
  50 .\"O If \fIwc\fP is a valid wide character, it is pushed back onto the stream
  51 .\"O and thus becomes available for future wide character read operations.
  52 .\"O The file-position indicator is decremented by one or more.
  53 .\"O The end-of-file
  54 .\"O indicator is cleared.
  55 .\"O The backing storage of the file is not affected.
  56 \fIwc\fP が有効なワイド文字の場合、それをストリームへと戻して後の
  57 ワイド文字読み込み操作で取得できるようにする。ファイル位置(file-position)
  58 指示子は1以上戻される。ファイル終端(end-of-file)指示子はクリアされる。
  59 そのファイルの背後にある記憶媒体は影響を受けない。
  60 .PP
  61 .\"O Note: \fIwc\fP need not be the last wide-character read from the stream;
  62 .\"O it can be any other valid wide character.
  63 注意: \fIwc\fP はストリームから読み込んだ最後のワイド文字である必要はない。
  64 有効なワイド文字ならば何でも良い。
  65 .PP
  66 .\"O If the implementation supports multiple push-back operations in a row, the
  67 .\"O pushed-back wide characters will be read in reverse order; however, only one
  68 .\"O level of push-back is guaranteed.
  69 続けて複数のワイド文字を戻すことをサポートしている実装の場合は、
  70 戻したワイド文字は、戻したのとは逆の順番で読み込まれる。
  71 しかしこの場合でも一段階の戻ししか保証されていない。
  72 .\"O .SH "RETURN VALUE"
  73 .SH 返り値
  74 .\"O The
  75 .\"O .BR ungetwc ()
  76 .\"O function returns \fIwc\fP when successful, or \fBWEOF\fP upon
  77 .\"O failure.
  78 .BR ungetwc ()
  79 関数は成功した場合には \fIwc\fP を返す。
  80 失敗した場合には \fBWEOF\fP を返す。
  81 .\"O .SH "CONFORMING TO"
  82 .SH 準拠
  83 C99.
  84 .\"O .SH NOTES
  85 .SH 注意
  86 .\"O The behavior of
  87 .\"O .BR ungetwc ()
  88 .\"O depends on the
  89 .\"O .B LC_CTYPE
  90 .\"O category of the
  91 .\"O current locale.
  92 .BR ungetwc ()
  93 関数の動作は現在のロケールの
  94 .B LC_CTYPE
  95 カテゴリに依存している。
  96 .\"O .SH "SEE ALSO"
  97 .SH 関連項目
  98 .BR fgetwc (3)