다음을 통해 공유


_getw

스트림에서 정수를 가져옵니다.

구문

int _getw(
   FILE *stream
);

매개 변수

stream
FILE 구조체에 대한 포인터입니다.

반환 값

_getw는 읽은 정수 값을 반환합니다. 반환 값 EOF는 오류 또는 파일 끝을 나타냅니다. 그러나 EOF 값은 올바른 정수 값이기도 하기 때문에 파일 끝 또는 오류 조건을 확인하려면 feof 또는 ferror를 사용하십시오. 검사점 생성 시 streamNULL인 경우 Parameter Validation를 참조하세요. 계속해서 실행하도록 허용된 경우 errnoEINVAL 로 설정되고 함수에서 EOF버전입니다.

설명

함수는 _getw 연결된 stream 파일에서 형식 int 의 다음 이진 값을 읽고 연결된 파일 포인터(있는 경우)를 증가하여 읽지 않은 다음 문자를 가리킵니다. _getw 는 스트림에 있는 항목의 특수 맞춤을 가정하지 않습니다. _getw 형식의 크기와 int 형식 내 바이트의 순서가 시스템마다 다르기 때문에 int에서 이식 관련 문제가 발생할 수 있습니다.

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

요구 사항

루틴에서 반환된 값 필수 헤더
_getw <stdio.h>

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

예시

// 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" );
   else
   {
      // Read a word from the stream:
      i = _getw( stream );

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

입력: crt_getw.txt

Line one.
Line two.

출력

First data word in file: 0x656e694c

참고 항목

스트림 I/O
_putw