gets_s _getws_s
從 stdin 資料流會取得一行。 這些是 取得， _getws 版本與安全性增強的如 安全性功能，則在 CRT 中中所述。
char *gets_s(
char *buffer,
size_t sizeInCharacters
);
wchar_t *_getws_s(
wchar_t *buffer,
size_t sizeInCharacters
);
template <size_t size>
char *gets_s(
char (&buffer)[size]
); // C++ only
template <size_t size>
wchar_t *_getws_s(
wchar_t (&buffer)[size]
); // C++ only
參數
[out] buffer
輸入字串的儲存位置。[in] sizeInCharacters
緩衝區的大小。
傳回值
如果成功，會傳回 buffer。 NULL 指標表示一個錯誤或文件關閉條件。 使用 ferror 或 feof 來判斷哪個時發生。
備註
gets_s 函式。 buffer會從標準輸入資料流的 stdin 一行並儲存它。 行包括所有字元一直到第一個新行字元 (「\ n」)。 gets_s 是 null 字元 (「\ 0 "然後取代新行字元 (Newline Character) 在傳回前一行。 相反地， fgets_s 函式會將新行字元。
如果第一個字元是讀取檔案結尾字元， null 字元在 buffer 前端儲存，而則會傳回 NULL 。
_getws 是 gets_s的寬字元版本;它的引數和傳回值是寬字元字串。
如果 buffer 是 NULL 或 sizeInCharacters 小於或等於零，或者，如果緩衝區太小無法包含匯出入列和 null 結束字元，這些函式叫用無效的參數處理常式，如 參數驗證中所述。 如果執行允許繼續執行，這些函式傳回 NULL 與 ERANGE集合 errno。
在 C++ 中，使用這些函式由範本多載簡化;多載會推斷緩衝區長度 (自動排除指定大小引數)，也可以用它們較新，安全對應自動取代舊，不安全的函式。 如需詳細資訊，請參閱安全範本多載。
泛用文字常式對應
TCHAR.H 常式 |
未定義 _UNICODE & _MBCS |
已定義 _MBCS |
已定義 _UNICODE |
|---|---|---|---|
_getts |
gets_s |
gets_s |
_getws |
需求
程序 |
必要的標頭檔 |
|---|---|
gets_s |
<stdio.h> |
_getws |
<stdio.h> 或 <wchar.h> |
主控台 Windows 市集 應用程式不支援。 標準資料流控制代碼與主控台， stdin， stdout和 stderr，在這種情況下， C 執行階段函式在 Windows 市集 應用程式之前，可以使用它們必須重新導向。 如需其他相容性資訊，請參閱入門介紹中的 相容性 (Compatibility) 。
範例
// crt_gets_s.c
// This program retrieves a string from the stdin and
// prints the same string to the console.
#include <stdio.h>
int main( void )
{
char line[21]; // room for 20 chars + '\0'
gets_s( line, 20 );
printf( "The line entered was: %s\n", line );
}