Share via

_ungetc_nolock、_ungetwc_nolock

  • [アーティクル]

更新 : 2007 年 11 月

ストリームに文字を戻します。

int _ungetc_nolock(
   int c,
      FILE *stream 
);
wint_t _ungetwc_nolock(
   wint_t c,
   FILE *stream 
);

パラメータ

  • c
    戻す文字。

  • stream
    FILE 構造体へのポインタ。

戻り値

成功した場合、これらの各関数は、c 文字引数を返します。c を戻すことができない場合または文字を読み取らなかった場合は、入力ストリームは変更されず、_ungetc_nolock は EOF を返し、_ungetwc_nolock は WEOF を返します。stream が NULL の場合、EOF または WEOF が返され、errno が EINVAL に設定されます。

エラー コードの詳細については、「_doserrno、errno、_sys_errlist、および _sys_nerr」を参照してください。

解説

これらの関数は、ungetc 関数と ungetwc 関数のロックを行わないバージョンです。_nolock サフィックスが付けられたバージョンは、他のスレッドからの干渉から保護されない点を除いて同じです。スレッドをロックアウトするオーバーヘッドがないので、この方が処理が早くなります。これらの関数は、シングルスレッド アプリケーションや、呼び出し元のスコープで既にスレッドの隔離が処理されている場合などの、スレッド セーフなコンテキストだけで使用します。

汎用テキスト ルーチンのマップ

TCHAR.H のルーチン

_UNICODE および _MBCS が未定義の場合

_MBCS が定義されている場合

_UNICODE が定義されている場合

_ungettc_nolock

_ungetc_nolock

_ungetc_nolock

_ungetwc_nolock

必要条件

ルーチン

必須ヘッダー

_ungetc_nolock

<stdio.h>

_ungetwc_nolock

<stdio.h> または <wchar.h>

互換性の詳細については、「C ランタイム ライブラリ」の「互換性」を参照してください。

.NET Framework の相当するアイテム

適用できません。標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。

参照

参照

ストリーム入出力

getc、getwc

putc、putwc