_cgets_s, _cgetws_s

아티클
04/10/2013

콘솔에서 문자열을 가져옵니다.이러한 버전의 _cgets 및 _cgetws 에 설명 된 대로 보안을 강화 하 고 있는 CRT의 보안 기능.

중요
이 API를 실행 하는 응용 프로그램에서 사용할 수 있는 Windows 런타임.자세한 내용은 /zw에 지원 되는 CRT 함수.

errno_t _cgets_s( 
   char *buffer,
   size_t numberOfElements,
   size_t *pSizeRead
);
errno_t _cgetws_s(
   wchar_t *buffer
   size_t numberOfElements,
   size_t *pSizeRead
);
template <size_t size>
errno_t _cgets_s( 
   char (&buffer)[size],
   size_t *pSizeRead
); // C++ only
template <size_t size>
errno_t _cgetws_s(
   wchar_t (&buffer)[size],
   size_t *pSizeRead
); // C++ only

매개 변수

[out] buffer
데이터에 대 한 저장소 위치입니다.
[in] numberOfElements
또한 읽을 수 있는 문자의 최대 수는 싱글바이트 또는 와이드 문자 버퍼의 크기입니다.
[in] pSizeRead
실제로 읽은 문자 수입니다.

반환 값

반환 값은 성공 하면 0입니다. 그렇지 않으면 오류 코드 오류가 발생 하는 경우

오류 조건

buffer	numberOfElements	pSizeRead	Return	내용buffer
NULL	any	any	EINVAL	n/a
없습니다NULL	0	any	EINVAL	수정 되지 않음
없습니다NULL	any	NULL	EINVAL	길이가 0 인 문자열

설명

_cgets_s및 _cgetws_s 콘솔에서 문자열을 읽고 문자열 (null 종결자)을 복사 buffer._cgetws_s함수의 와이드 문자 버전이입니다. 문자 크기 이외의 이러한 두 함수의 동작을 동일합니다.읽을 수 있는 문자열의 최대 크기에 변수로 전달 되는 numberOfElements 매개 변수입니다.이 크기는 여분의 문자 종료 null 포함 해야 합니다.읽을 문자의 실제 수에 pSizeRead.

매개 변수 유효성을 검사 또는 작업 중에 오류가 발생 하는 경우 잘못 된 매개 변수 처리기를의 설명에 따라 호출 됩니다 매개 변수 유효성 검사 .실행을 계속 하려면 허용 되는 경우 errno 로 설정 된 EINVAL 및 EINVAL 이 반환 됩니다.

C + +에서는 이러한 함수를 사용 하는 템플릿 오버 로드에 의해 간단해 집니다. 오버 로드 자동으로 size 인수를 지정할 필요가 없도록 버퍼 길이 유추할 수 있으며 해당 최신이 고 보다 안전한 이미지와 보안 수준이 낮은 오래 된 함수로 자동으로 바꿀 수 있습니다.자세한 내용은 보안 템플릿 오버 로드을 참조하십시오.

일반 텍스트 루틴 매핑

Tchar.h 루틴	_UNICODE 및 _mbcs가 정의 되어 있지 않습니다	_Mbcs가 정의	_Unicode가 정의
_cgetts_s	_cgets_s	_cgets_s	_cgetws_s

요구 사항

루틴	필수 헤더
_cgets_s	<conio.h>
_cgetws_s	<conio.h> 또는 <wchar.h>

자세한 호환성에 대 한 내용은 호환성.

해당 .NET Framework 항목

해당 사항 없음. 표준 C 함수를 호출 하려면 PInvoke. 자세한 내용은 플랫폼 호출 예제을 참조하십시오.

참고 항목

참조

콘솔 및 포트 I/O

_getch, _getwch

다음을 통해 공유