모두의 코드
C 언어 레퍼런스 - fscanf 함수

작성일 : 2010-02-22 이 글은 42651 번 읽혔습니다.

아직 C 언어와 친숙하지 않다면, 씹어먹는 C 언어 강좌를 보는 것이 어떻까요?

fscanf

#include <stdio.h>  // C++ 에서는 <cstdio>

int fscanf(FILE* stream, const char* format, ...);

스트림에서 데이터를 특정한 형식으로 읽어온다.

스트림에서 형식 문자열에서 지정한 방식대로 데이터를 읽어온 후, 형식 문자열의 각각의 형식 지정자에 대응하는 인자가 가리키는 메모리 공간에 그 데이터를 집어 넣는다.

인자

stream

데이터를 읽어올 스트림의 FILE 객체를 가리키는 포인터

format

C 형식 문자열로 다음의 것들을 포함하고 있 C 형식 문자열로 다음의 것들을 포함하고 있다

  • 공백 문자 (Whitespace character 이라 부르며, 개행 문자(\n), 탭 문자, 띄어쓰기(' ') 이다) : fscanf 함수는 비-공백 문자를 읽어들이기 전까지 읽혀지는 모든 공백 문자들을 무시한다.

  • 비-공백 문자 (Non whitespcae character), 단 % 를 제외한다 : 공백 문자가 아니거나 형식 지정자에 포함되지 않는 것들은 함수로 하여금 다음 문자를 스트림에서 읽어 들이고 이와 이 비-공백 문자와 비교하여 같다면 버리고 다음 문자와 형식으로 진행한다. 만일 다르다면 함수가 종료되고, 스트림에서 읽혀지지 않은 다른 문자들은 모두 남아있게 된다.

  • 형식 지정자 : 이는 % 로 지정되는 것들로 스트림에서 어떠한 형식으로 데이터를 읽어오고, 또 각각의 형식 지정자에 대응되는 인자에 어떠한 형식으로 저장할 지에 대해 결정한다. 형식 지정자는 아래와 같은 꼴로 생겼다.

%[*][폭(width)][한정자(modifiers)]타입(type)
종류설명
*데이터를 stdin 에서 받아들이지만 무시된다. 물론, 이에 대응되는 인자에는 받아들인 데이터가 저장되지 않고 이 인자는 다음 형식 태그에 대응된다. 예를 들어 fscanf(fp, "%*d%d", i,j); 의 경우 먼저 수를 입력하더라도 %*d 형식이므로 무시 된다. 그 다음 수를 입력하면 %d 형식 태그가 j 가 아닌 i 에 대응되어 i 에 그 다음 입력한 수가 들어가게 된다. 이 때 j 에는 아무런 값도 들어가지 않는다.
stdin 에서 읽어들일 최대 문자 수를 지정한다. 예를 들어 fscanf(fp, "%10s", str); 로 했을 경우 stdin 에서 최대 10 문자를 읽어와 str 에 저장한다. 이 때 주의할 점은 str 에는 NULL 문자가 들어갈 수 있는 충분한 공간이 남아 있어야 한다.
한정자입력받는 데이터의 크기를 지정한다. int, unsigned int, float 형에 대해 입력받는 데이터의 크기를 설정할 수 있다. h 의 경우 short int (d, i, n 의 경우) 혹은 unsigned short int (o, u, x 일 경우). l 의 경우 long int (d, i, n 의 경우) 혹은 unsigned long int (o, u, x 일 경우), 혹은 double (e, f, g 일 경우). 마지막으로 L 의 경우 long double (e, f, g 일 경우) 에 사용할 수 있다.
타입데이터를 어떠한 형식으로 혹은 어떠한 값만을 읽어들어야 할 지에 대해 지정해준다. 아래 표를 참고.

fscanf 함수의 타입 지정자들

타입대응되는 입력 방식대응되는 인자의 형태
d십진법으로 표현된 정수: 말그대로 십진법으로 쓰인 정수로, +- 기호로 시작할 수도 있다.int *
e, E, f, g, G부동 소수점: 소수점을 포함하고 있는 소수(decimal number) 로 +- 기호로 시작할 수도 있으며, eE 문자(10 의 지수를 나타내기 위해)를 포함할 수 도 있다. -732.103, 12e-4, +123.10 은 모두 올바른 입력이다.float *
o8진법으로 표현된 정수int *
s문자열: 공백문자를 찾을 때 까지 문자들을 읽어들인다.char *
u부호가 없는 십진법으로 표현된 정수unsigned int *
x, X16진법으로 표현된 정수int *

부수적 인자

형식 문자열의 정의된 순서대로 각 형식 지정자는 이에 대응하는 인자가 가리키는 메모리 공간에 데이터를 집어넣는다. 이 때, 부수적 인자들은 모두 포인터의 형태 (주소값) 여야 한다. 예를 들어서 i 라는 변수에 값을 대입하려면 인자로 &i 를 전달해야 한다. 절대로 i 를 전달하면 안된다.

에를 들면 아래와 같다.

FILE *fp = fopen("out.txt", "w");
int i;
fscanf(fp, "%d", &i); /* 꼭 주소값을 전달해야 된다는 점에 유의! */

리턴값

성공할 경우, fscanf 함수는 읽어들인 데이터의 수를 리턴한다. 만일 어떠한 데이터도 형식 지정자와 일치하는 것이 없다면 0 이 될 수 도 있다.

만일 어떠한 데이터도 성공적으로 읽어들이기 전에 입력이 실패한다면 EOF 가 리턴된다.

실행 예제

/*

myfile.txt 에 3.1416 과 PI 를 쓴 뒤, 이를 다시 myfile.txt 에서 읽어들인다. 이
때, myfile.txt 를 w+ 형식으로 열었으므로 출력 뒤에 입력을 하기 위해서는 fflush
나 rewind 와 같은 파일 위치 지정자 조정 함수를 호출해야 하는데 이 경우 rewind
함수를 호출하여 위치 표시자를 맨 앞으로 돌렸다.

 */
#include <stdio.h>
int main() {
  char str[80];
  float f;
  FILE* pFile;

  pFile = fopen("myfile.txt", "w+");
  fprintf(pFile, "%f %s", 3.1416, "PI");
  rewind(pFile);
  fscanf(pFile, "%f", &f);
  fscanf(pFile, "%s", str);
  fclose(pFile);
  printf("I have read: %f and %s \n", f, str);
  return 0;
}

실행 결과

파일에 쓰여진 모습

참고 자료

  • scanf : 표준 입력(stdin) 에서 데이터를 특정한 형식으로 읽어온다.

  • fprintf : 스트림에 특정한 형식으로 데이터를 쓴다.

  • fread : 스트림에서 데이터 블록을 읽어온다.

  • fgets : 스트림에서 문자열을 읽어온다.

댓글이 2 개 있습니다!
프로필 사진 없음
강좌에 관련 없이 궁금한 내용은 여기를 사용해주세요