gets、_getws

發行項
06/09/2015

從 stdin 資料流會取得一行。更多這些函式的可用安全版本，請參閱 gets_s、_getws_s。

重要

這個應用程式開發介面不能用於 Windows 執行階段執行的應用程式。如需詳細資訊，請參閱 /ZW 不支援 CRT 函式。

char *gets( 
   char *buffer 
);
wchar_t *_getws( 
   wchar_t *buffer 
);
template <size_t size>
char *gets( 
   char (&buffer)[size]
); // C++ only
template <size_t size>
wchar_t *_getws( 
   wchar_t (&buffer)[size]
); // C++ only

參數

buffer
輸入字串的儲存位置。

傳回值

如果成功，傳回它的引數。 NULL 指標表示一個錯誤或文件關閉條件。使用 ferror 或 feof 來判斷哪個發生。如果 buffer 為 NULL，這些函式會叫用無效參數處理常式，如參數驗證中所述。如果允許繼續執行，這些函式會傳回 NULL，並將 EINVAL 設為 errno。

備註

gets 函式會從標準輸入資料流 stdin 讀入一行並儲存它在buffer。此行包括一直到第一個新行字元 (「\ n」) 的所有字元。 gets 是在傳回前一行 null 字元 (「\ 0 」) 取代之新行字元。相反地， fgets 函式會保持新行字元。 _getws 是 gets 的寬字元版本；函式的引數和回傳值是寬字元字串。

安全性提示
由於無法限制所讀取的字元數，取得不信任的輸入可能很容易導致緩衝區滿溢。請改用 fgets。

在 C++ 中，這些函式具有多載樣板，可以叫用更新、更安全的這些函式的相對版本。如需詳細資訊，請參閱安全範本多載。

一般文字常式對應

TCHAR.H 常式	未定義 _UNICODE & _MBCS	已定義 _MBCS	已定義 _UNICODE
_getts	gets	gets	_getws

需求

常式	必要的標頭
gets	<stdio.h>
_getws	<stdio.h> 或 <wchar.h>

如需其他相容性資訊，請參閱相容性。

範例

// crt_gets.c
// compile with: /WX /W3

#include <stdio.h>

int main( void )
{
   char line[21]; // room for 20 chars + '\0'
   gets( line );  // C4996
   // Danger: No way to limit input to 20 chars.
   // Consider using gets_s instead.
   printf( "The line entered was: %s\n", line );
}

請注意輸入超過 20 個字元長度將滿溢列緩衝區且幾乎會使程式當機。