gets_s, _getws_s

從 stdin 資料流取得行。 這些版本的 gets 具有 _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

參數

buffer
輸入字串的儲存體位置。

sizeInCharacters
緩衝區的大小。

傳回值

若成功，會傳回 buffer。 NULL 指標表示錯誤或檔案結尾條件。 使用 ferror 或 feof 來判斷發生哪一個。

備註

gets_s 函式會從標準輸入資料流 stdin 讀取一行，並將其儲存在 buffer中。 這一行由所有字元組成，最多包含第一個新行字元 （'' \n ' ）。 gets_s 然後在傳回行之前，將分行符號取代為 Null 字元 （'' \0 ）。 相反地，fgets_s 函式則會保留新行字元。

如果第一個字元讀取是檔案結尾字元，則會在 的開頭 buffer 儲存 Null 字元，並 NULL 傳回 。

_getws_s 是 gets_s 的寬字元版本；其引數與傳回值為寬字元字串。

如果 buffer 為 NULL 或 sizeInCharacters 小於或等於零，或緩衝區太小而無法包含輸入行和 Null 結束字元，則這些函式會叫用不正確參數處理常式，如參數驗證 中所述 。 若允許繼續執行，這些函式會傳回 NULL ，並將 errno 設為 ERANGE。

C++ 利用多載樣板簡化了這些函式的使用方式。多載可自動推斷緩衝區長度 (因而不須指定大小引數)，也可以將不安全的舊函式自動取代成較新且安全的對應函式。 如需詳細資訊，請參閱 保護範本多載 。

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

泛型文字常式對應

TCHAR.H 常規	_UNICODE 和 _MBCS 未定義	_MBCS 定義	_UNICODE 定義
_getts_s	gets_s	gets_s	_getws_s

需求

常式	必要的標頭
gets_s	<stdio.h>
_getws_s	<stdio.h> 或 <wchar.h>

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

範例

// 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 );
}

Hello there!

The line entered was: Hello there!

另請參閱

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