Функции библиотеки 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.12e4 | float * |
| 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|Другие расширения