스트림에서 정수를 가져옵니다.Gets an integer from a stream.


int _getw(
   FILE *stream

매개 변수Parameters

FILE 구조체에 대한 포인터입니다.Pointer to the FILE structure.

Return ValueReturn Value

_getw 읽은 정수 값을 반환 합니다._getw returns the integer value read. EOF 의 반환 값은 오류 또는 파일 끝을 나타냅니다.A return value of EOF indicates either an error or end of file. 그러나 EOF 값도 올바른 정수 값 이므로 feof ferror 를 사용 하 여 파일 끝 또는 오류 조건을 확인 합니다.However, because the EOF value is also a legitimate integer value, use feof or ferror to verify an end-of-file or error condition. StreamNULL인 경우 매개 변수 유효성 검사에 설명 된 대로 잘못 된 매개 변수 처리기가 호출 됩니다.If stream is NULL, the invalid parameter handler is invoked, as described in Parameter Validation. 계속 해 서 실행 하도록 허용한 경우 errnoEINVAL 로 설정 되 고 함수는 EOF를 반환 합니다.If execution is allowed to continue, errno is set to EINVAL and the function returns EOF.


_Getw 함수는 스트림과 연결 된 파일에서 형식의 다음 이진 값을 읽고 int 읽지 stream 않은 다음 문자를 가리키도록 연결 된 파일 포인터 (있는 경우)를 증가 시킵니다.The _getw function reads the next binary value of type int from the file associated with stream and increments the associated file pointer (if there is one) to point to the next unread character. _getw 는 스트림의 항목에 대 한 특별 한 맞춤을 가정 하지 않습니다._getw does not assume any special alignment of items in the stream. _getw int 형식의 크기와 형식 내 바이트의 순서가 시스템 마다 다르기 때문에 _getw를 사용 하는 데 문제가 발생할 수 있습니다 int .Problems with porting can occur with _getw because the size of the int type and the ordering of bytes within the int type differ across systems.

기본적으로이 함수의 전역 상태는 응용 프로그램으로 범위가 지정 됩니다.By default, this function's global state is scoped to the application. 이를 변경 하려면 CRT의 전역 상태를 참조 하세요.To change this, see Global state in the CRT.

요구 사항Requirements

루틴에서 반환된 값Routine 필수 헤더Required header
_getw_getw <stdio.h>

호환성에 대한 자세한 내용은 Compatibility을 참조하세요.For more compatibility information, see Compatibility.


// crt_getw.c
// This program uses _getw to read a word
// from a stream, then performs an error check.

#include <stdio.h>
#include <stdlib.h>

int main( void )
   FILE *stream;
   int i;

   if( fopen_s( &stream, "crt_getw.txt", "rb" ) )
      printf( "Couldn't open file\n" );
      // Read a word from the stream:
      i = _getw( stream );

      // If there is an error...
      if( ferror( stream ) )
         printf( "_getw failed\n" );
         clearerr_s( stream );
         printf( "First data word in file: 0x%.4x\n", i );
      fclose( stream );

입력: crt_getw.txtInput: crt_getw.txt

Line one.
Line two.


First data word in file: 0x656e694c

참조See also

스트림 I/OStream I/O