gets、_getws

發行項
03/27/2013

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

重要事項
這個 API 不能用於 Windows 執行階段執行的應用程式。如需詳細資訊，請參閱 CRT 函式不支援使用 /ZW。

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 函式。 buffer會從標準輸入資料流的 stdin 一行並儲存它。行包括所有字元一直到第一個新行字元 (「\ n」)。gets 是 null 字元 (「\ 0 "然後取代新行字元 (Newline Character) 在傳回前一行。相反地， fgets 函式會將新行字元。_getws 是 gets的寬字元版本;它的引數和傳回值是寬字元字串。

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

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

泛用文字常式對應

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

需求

程序	必要的標頭檔
gets	<stdio.h>
_getws	<stdio.h> 或 <wchar.h>

如需其他相容性資訊，請參閱入門介紹中的相容性 (Compatibility) 。

範例

// 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 個字元長度將滿溢列緩衝區和幾乎一定會使程式當機。