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
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應