Функции библиотеки C -fscanf()

Стандартная библиотека C - <stdio.h>

Описание

Функции библиотеки Cint fscanf(FILE *stream, const char *format, ...)Читает форматированный ввод из потока.

Объявление

Ниже приведено объявление функции fscanf().

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

Параметр

  • stream-- Это указатель на объект FILE, который идентифицирует поток.
  • format-- Это строка C, содержащая один или несколько из следующих элементов:пробельные символы, непробельные символыиспецификаторы формата。
    Спецификатор формата имеет вид[=%[*][width][modifiers]type=], как подробно объясняется ниже:
ПараметрОписание
*Это необязательная звёздочка, означающая, что данные считываются из потока, но могут быть проигнорированы, т. е. не сохраняются в соответствующем аргументе.
widthЗадаёт максимальное количество символов, которые нужно считать в текущей операции чтения.
модификаторыЗадаёт для данных, на которые указывает соответствующий дополнительный аргумент, размер, отличный от размера для целого (для d, i и n), целого без знака (для o, u и x) или числа с плавающей запятой (для e, f и g): h: короткое целое (для d, i и n) или короткое целое без знака (для o, u и x) l: длинное целое (для d, i и n), или длинное целое без знака (для o, u и x), или double (для e, f и g) L: long double (для e, f и g)
typeСимвол, определяющий тип считываемых данных и способ их считывания. Подробности см. в следующей таблице.

Спецификаторы типа fscanf:

TypeКвалифицирующий вводтип аргумента
cОдиночный символ: считывает следующий символ. Если задана ширина, отличная от 1, функция считывает указанное количество символов и сохраняет их в последовательных позициях массива, переданного через аргумент. Нулевой символ в конце не добавляется.char *
dДесятичное целое: знак + или - перед числом необязателен.int *
e,E,f,g,GЧисло с плавающей запятой: содержит десятичную точку, необязательный ведущий знак + или -, необязательный завершающий символ e или E и десятичную цифру. Два допустимых примера: -732.103 и 7.12e4float *
oВосьмеричное целое число.int *
sСтрока. Считывает последовательные символы до тех пор, пока не встретится пробельный символ (пробельными символами могут быть пробелы, символы новой строки и табуляции).char *
uБеззнаковое десятичное целое число.unsigned int *
x,XШестнадцатеричное целое число.int *
  • Дополнительные аргументы-- В зависимости от строки форматирования функция может ожидать последовательность дополнительных аргументов, каждый из которых содержит значение для вставки, заменяющее каждый тег %, указанный в параметре format. Количество аргументов должно совпадать с количеством тегов %.

Возвращаемое значение

В случае успеха функция возвращает количество успешно сопоставленных и присвоенных элементов. Если достигнут конец файла или возникает ошибка чтения, она возвращает EOF.

Пример

В следующем примере демонстрируется использование функции fscanf().

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


int main()
{
   char str1[10], str2[10], str3[10];
   int year;
   FILE * fp;

   fp = fopen ("file.txt", "w+");
   fputs("We are in 2014", fp);
   
   rewind(fp);
   fscanf(fp, "%s %s %s %d", str1, str2, str3, &year);
   
   printf("Read String1 |%s|\n", str1 );
   printf("Read String2 |%s|\n", str2 );
   printf("Read String3 |%s|\n", str3 );
   printf("Read Integer |%d|\n", year );

   fclose(fp);
   
   return(0);
}

Давайте скомпилируем и запустим приведённую выше программу, которая выдаст следующий результат:

Read String1 |We|
Read String2 |are|
Read String3 |in|
Read Integer |2014|

Стандартная библиотека C - <stdio.h>

Другие расширения