gets, _getws

아티클
06/09/2015

stdin 스트림에서 줄을 가져옵니다. 이러한 기능의 더 안전한 버전을 사용할 수 있습니다. gets_s, _getws_s를 참조하십시오.

중요

이 API는 Windows 런타임에서 실행되는 응용 프로그램에서 사용할 수 없습니다.자세한 내용은 /ZW에서 지원하지 않는 CRT 함수를 참조하십시오.

char *gets( 
   char *buffer 
);
wchar_t *_getws( 
   wchar_t *buffer 
);
template <size_t size>
char *gets( 
   char (&buffer)[size]
); // C++ only
template <size_t size>
wchar_t *_getws( 
   wchar_t (&buffer)[size]
); // C++ only

매개 변수

buffer
입력 문자열에 대한 저장 위치입니다.

반환 값

성공적으로 인수를 반환 합니다. NULL 포인터는 오류나 파일의 끝 조건을 나타냅니다. 어떤 것이 발생했는지 확인 하려면 ferror 또는 feof 를 사용하십시오. 만일 buffer 이 NULL 인 경우 이러한 함수는 매개 변수 유효성 검사 에 설명된 대로 잘못된 매개 변수 처리기를 호출합니다. 계속해서 실행하도록 허용된 경우, 이러한 함수는 NULL 를 반환하고 errno를 EINVAL 로 설정합니다.

설명

이 gets 함수는 표준 입력 스트림 stdin 에서 읽은 줄을 buffer 에 저장합니다. 줄은 첫 번째 줄 바꿈 문자 ('\n')까지 모든 문자로 구성 됩니다. gets 는 줄을 반환하기 전에 줄 바꿈 문자를 Null 문자('\0') 로 대체합니다. 반면에, fgets 함수는 줄 바꿈 문자를 유지 합니다. _getws 는 gets 의 와이드 문자 버전입니다. 해당 인수와 반환 값은 와이드 문자 문자열입니다.

보안 정보
가져온 것에서 읽을 문자 수를 제한할 수 없기 때문에 신뢰할 수 없는 입력 버퍼 오버런이 쉽게 발생할 수 있습니다.대신 fgets를 사용하십시오.

C++에서 이러한 함수는 보다 최신의 보안 대응 함수를 호출하는 템플릿 오버로드를 갖고 있습니다. 자세한 내용은 안전한 템플릿 오버로드을 참조하십시오.

제네릭 텍스트 라우팅 매핑

TCHAR.H 루틴	_UNICODE 및 _MBCS 정의되지 않음	_MBCS 정의됨	_UNICODE 정의됨
_getts	gets	gets	_getws

요구 사항

루틴	필수 헤더
gets	<stdio.h>
_getws	<stdio.h> 또는 <wchar.h>

추가 호환성 정보는 호환성을 참조하십시오.

예제

// crt_gets.c
// compile with: /WX /W3

#include <stdio.h>

int main( void )
{
   char line[21]; // room for 20 chars + '\0'
   gets( line );  // C4996
   // Danger: No way to limit input to 20 chars.
   // Consider using gets_s instead.
   printf( "The line entered was: %s\n", line );
}

20 문자 이상 선 버퍼가 초과 실행된 입력에 주목하고, 거의 정확하게 프로그램은 충돌을 야기시킵니다.