_cgets_s, _cgetws_s

콘솔에서 문자열을 가져옵니다. CRT의 _cgets_cgetws보안 기능에 설명된 대로 이러한 버전의 보안 기능이 향상되었습니다.

Important

이 API는 Windows 런타임에서 실행되는 애플리케이션에서 사용할 수 없습니다. 자세한 내용은 유니버설 Windows 플랫폼 앱에서 지원되지 않는 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

매개 변수

buffer
데이터의 스토리지 위치입니다.

numberOfElements
단일 바이트 또는 와이드 문자 단위의 버퍼 크기이며, 읽을 수 있는 최대 문자 수이기도 합니다.

pSizeRead
실제로 읽은 문자 수입니다.

반환 값

성공할 경우 반환 값은 0이고, 그렇지 않고 오류가 발생할 경우 오류 코드를 반환합니다.

오류 조건

buffer	numberOfElements	pSizeRead	반환 값	buffer의 내용
NULL	any	any	EINVAL	해당 없음
NULL 아님	zero	any	EINVAL	수정 안 됨
NULL 아님	any	NULL	EINVAL	빈 문자열

설명

_cgets_s 및 _cgetws_s는 콘솔에서 문자열을 읽고 null 종결자를 사용하여 문자열을 buffer에 복사합니다. _cgetws_s는 함수의 와이드 문자 버전이며, 문자 크기가 아니라 이러한 두 함수의 동작이 동일합니다. 읽을 수 있는 문자열의 최대 크기는 numberOfElements 매개 변수로 전달됩니다. 이 크기는 종료 null에 대한 추가 문자를 포함해야 합니다. 읽은 실제 문자 수는 pSizeRead에 배치됩니다.

작업 중 또는 매개 변수 유효성 검사 중에 오류가 발생하면 매개 변수 유효성 검사에 설명된 대로 잘못된 매개 변수 처리기가 호출됩니다. 실행을 계속 errno 하도록 허용되면 로 EINVAL설정되고 EINVAL 반환됩니다.

C++에서 이러한 함수의 사용은 템플릿 오버로드에 의해 간소화됩니다. 오버로드는 버퍼 길이를 자동으로 유추할 수 있으므로 크기 인수를 지정할 필요가 없습니다. 또한 이전의 덜 안전한 함수를 더 새롭고 안전한 함수로 자동으로 대체할 수도 있습니다. 자세한 내용은 보안 템플릿 오버로드를 참조 하세요.

이러한 함수의 디버그 라이브러리 버전은 먼저 버퍼를 0xFE 채웁니다. 이 동작을 사용하지 않도록 설정하려면 .를 사용합니다 _CrtSetDebugFillThreshold.

기본적으로 이 함수의 전역 상태는 애플리케이션으로 범위가 지정됩니다. 이 동작을 변경하려면 CRT의 전역 상태를 참조하세요.

일반 텍스트 루틴 매핑

Tchar.h 루틴	_UNICODE 정의 _MBCS 되지 않음	_MBCS 정의	_UNICODE 정의
_cgetts_s	_cgets_s	_cgets_s	_cgetws_s

요구 사항

루틴에서 반환된 값	필수 헤더
_cgets_s	<conio.h>
_cgetws_s	<conio.h> 또는 <wchar.h>

호환성에 대한 자세한 내용은 호환성을 참조하세요.

참고 항목

콘솔 및 포트 I/O
_getch, _getwch