gets, _getws

從 stdin 資料流取得行。 這些函式有更安全的版本可供使用;請參閱 gets_s 、 _getws_s 。

重要

這些函式已被取代。 自 Visual Studio 2015 起，這些函式即無法在 CRT 中使用。 這些函 gets_s 式和 _getws_s 的安全版本仍可供使用。 如需這些替代函式的詳細資訊，請參閱 gets_s 。 _getws_s

重要

這個 API 不能用於在 Windows 執行階段中執行的應用程式。 如需詳細資訊，請參閱 CRT functions not supported in Universal Windows Platform apps (通用 Windows 平台應用程式中不支援的 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，並將 errno 設為 EINVAL。

備註

gets 函式會從標準輸入資料流 stdin 讀取一行，並將其儲存在 buffer中。 此行包括到第一個新行字元 ('\n') (含) 的所有字元。 gets 接著會取代以 null 字元 ('\0') 取代新行字元，然後再傳回該行。 相反地，fgets 函式則會保留新行字元。 _getws 是 gets 的寬字元版本；其引數與傳回值為寬字元字串。

重要

由於無法限制 所 gets 讀取的字元數，因此不受信任的輸入很容易造成緩衝區滿溢。 請改用 fgets。

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

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

泛型文字常式對應

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 個字元將會超過行緩衝區，而且幾乎可以肯定導致程式當機。

Hello there!The line entered was: Hello there!

另請參閱

資料流 I/O
fgets, fgetws
fputs, fputws
puts, _putws