_cgets, _cgetws

콘솔에서 문자열을 가져옵니다. 이러한 함수의 더 안전한 버전을 사용할 수 있습니다. _cgets_s, _cgetws_s를 참조하세요.

중요

이러한 함수는 사용되지 않습니다. Visual Studio 2015부터 CRT에서 사용할 수 없습니다. 이러한 함수의 안전한 버전인 _cgets_s 및 _cgetws_s는 계속 사용할 수 있습니다. 이러한 대체 함수에 대한 자세한 내용은 _cgets_s, _cgetws_s를 참조하세요.

중요

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

구문

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

매개 변수

buffer
데이터의 저장소 위치입니다.

반환 값

_cgets_cgetwsbuffer[2]에서 문자열의 시작에 대한 포인터를 반환합니다. bufferNULL인 경우 이러한 함수는 매개 변수 유효성 검사에 설명된 대로 잘못된 매개 변수 처리기를 호출합니다. 계속해서 실행하도록 허용된 경우, 이러한 함수는 NULL 을 반환하고 errnoEINVAL로 설정합니다.

설명

이러한 함수는 콘솔에서 문자열을 읽고 문자열과 해당 길이를 buffer가 가리키는 위치에 저장합니다. buffer 매개 변수는 문자 배열에 대한 포인터여야 합니다. 배열의 첫 번째 요소인 buffer[0]에는 읽을 문자열의 최대 길이(문자)가 포함되어야 합니다. 배열에 문자열, 종료 null 문자('\0') 및 추가 2바이트를 저장하는 데 충분한 요소가 포함되어야 합니다. 함수는 CR-LF(캐리지 리턴-줄 바꿈) 조합이나 지정된 개수의 문자를 읽을 때까지 문자를 읽습니다. buffer[2]부터 시작하여 문자열이 저장됩니다. 함수는 CR-LF를 읽을 경우 null 문자('\0')를 저장합니다. 그런 다음 문자열의 실제 길이를 두 번째 배열 요소인 buffer[1]에 저장합니다.

콘솔 창에 있는 동안 _cgets 또는_cgetws를 호출한 경우 모든 편집 키가 활성 상태이기 때문에 F3 키를 누르면 마지막으로 입력한 항목이 반복됩니다.

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

제네릭 텍스트 라우팅 매핑

Tchar.h 루틴 _UNICODE 및 _MBCS 정의되지 않음 _MBCS 정의됨 _UNICODE 정의됨
_cgetts _cgets _cgets _cgetws

요구 사항

루틴 필수 헤더
_cgets <conio.h>
_cgetws <conio.h> 또는 <wchar.h>

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

예제

// crt_cgets.c  
// compile with: /c /W3  
// This program creates a buffer and initializes  
// the first byte to the size of the buffer. Next, the  
// program accepts an input string using _cgets and displays  
// the size and text of that string.  

#include <conio.h>  
#include <stdio.h>  
#include <errno.h>  

int main( void )  
{  
   char buffer[83] = { 80 };  // Maximum characters in 1st byte  
   char *result;  

   printf( "Input line of text, followed by carriage return:\n");  

   // Input a line of text:  
   result = _cgets( buffer ); // C4996  
   // Note: _cgets is deprecated; consider using _cgets_s  
   if (!result)  
   {  
      printf( "An error occurred reading from the console:"  
              " error code %d\n", errno);  
   }  
   else  
   {     
      printf( "\nLine length = %d\nText = %s\n",  
              buffer[1], result );  
   }  
}  

      A line of input.Input line of text, followed by carriage return:  
Line Length = 16  
Text = A line of input.  

참고 항목

콘솔 및 포트 I/O
_getch, _getwch