ungetc, ungetwc

將字元推入回資料流。

語法

int ungetc(
   int c,
   FILE *stream
);
wint_t ungetwc(
   wint_t c,
   FILE *stream
);

參數

c
要推送的字元。

stream
FILE 結構的指標。

傳回值

如果成功，則每個函式都會傳回字元引數 c 。 如果 c 無法回推或未讀取任何字元，則輸入資料流程不會變更並 ungetc 傳回 ; ungetwc 會傳 WEOF 回 EOF 。 如果 stream 為 NULL ，則會叫用不正確參數處理常式，如參數驗證 中所述 。 如果允許繼續執行， EOF 或 WEOF 傳回 ，且 errno 設定為 EINVAL 。

如需這些錯誤碼和其他錯誤碼的相關資訊，請參閱 errno 、 _doserrno_sys_errlist 和 _sys_nerr 。

備註

ungetc 函式會將字元 c 推入至 stream，並清除檔案結尾指標。 資料流必須是開啟可供讀取。 上的 stream 後續讀取作業會以 開頭 c 。 會忽略嘗試使用 ungetc 將 EOF 推至資料流。

如果在從資料流讀取字元之前呼叫 fflush、fseek、fsetpos 或 rewind，ungetc 放在資料流的字元可能會被刪除。 檔案位置指標將具有在回推字元之前它所具有的值。 對應至資料流外部儲存體會保持不變。 在針對文字資料流的成功 ungetc 呼叫，將不會指定檔案位置指標，直到所有回推的字元都已讀取或捨棄為止。 在針對二進位資料流的每個成功 ungetc 呼叫，檔案位置指標會減少；如果其值在呼叫之前為 0，該值在呼叫之後為未定義。

如果呼叫 ungetc 兩次，而在兩次呼叫之間沒有讀取或檔案位置的作業，將無法預測結果。 呼叫 fscanf 之後，除非已執行另一個讀取作業， getc 否則對 的呼叫 ungetc 可能會失敗，因為 fscanf 本身會呼叫 ungetc 。

ungetwc 是 ungetc 的寬字元版本。 不過，在針對文字或二進位資料流的每個成功 ungetwc 呼叫，將不會指定檔案位置指標，直到所有回推的字元都已讀取或捨棄為止。

這些函式是安全執行緒，並且會在執行期間鎖定機密資料。 如需非鎖定版本，請參閱 _ungetc_nolock 。 _ungetwc_nolock

根據預設，此函式的全域狀態會限定于應用程式。 若要變更此行為，請參閱 CRT 中的全域狀態。

泛型文字常式對應

TCHAR.H 常式	_UNICODE 和 _MBCS 未定義	_MBCS 定義	_UNICODE 定義
_ungettc	ungetc	ungetc	ungetwc

需求

常式	必要的標頭
ungetc	<stdio.h>
ungetwc	<stdio.h > 或 < wchar.h>

通用 Windows 平臺 （UWP） 應用程式中不支援主控台。 與主控台、 stdin 、 stdout 和 stderr 相關聯的標準資料流程控制碼必須先重新導向，C 執行時間函式才能在 UWP 應用程式中使用這些控制碼。 如需相容性詳細資訊，請參閱相容性。

範例

// crt_ungetc.c
// This program first converts a character
// representation of an unsigned integer to an integer. If
// the program encounters a character that is not a digit,
// the program uses ungetc to replace it in the  stream.
//

#include <stdio.h>
#include <ctype.h>

int main( void )
{
   int ch;
   int result = 0;

   // Read in and convert number:
   while( ((ch = getchar()) != EOF) && isdigit( ch ) )
      result = result * 10 + ch - '0';    // Use digit.
   if( ch != EOF )
      ungetc( ch, stdin );                // Put nondigit back.
   printf( "Number = %d\nNext character in stream = '%c'",
            result, getchar() );
}

      521aNumber = 521
Next character in stream = 'a'

另請參閱

資料流 I/O
getc, getwc
putc, putwc