上海网站制作顾问,官网微信,多少钱才算有钱人,建设工程施工合同2021cstdio,在C语言中称为stdio.h。该库使用所谓的流与物理设备#xff08;如键盘、打印机、终端#xff09;或系统支持的任何其他类型的文件一起操作。
在本文将会通过介绍函数参数#xff0c;举出实际的简单例子来帮助大家快速上手使用函数。
目录
一、流 二、库函数
1、F…
cstdio,在C语言中称为stdio.h。该库使用所谓的流与物理设备如键盘、打印机、终端或系统支持的任何其他类型的文件一起操作。
在本文将会通过介绍函数参数举出实际的简单例子来帮助大家快速上手使用函数。
目录
一、流 二、库函数
1、File access文件访问 fclose
fflush
fopen
freopen:
setbuf :
setvbuf :
2、Operations on files对文件的操作
remove rename tmofile
tmpnam
3、Formatted input/output格式化的输入/输出
fprintf:
fscanf
snprintf : sprintf
sscanf
vfprintf
vfscanf
vprintf
vscanf
vsnprintf
vsprintf
4、Character input/output:字符输入/输出
fgetc
fgets fputc
fputs
getc getchar
gets
putc
putchar:
ungetc
5、Direct input/output直接输入/输出
fread
fwrite
6、Error-handling错误处理
clearerr
feof
ferror
perror
7、Types类型
FILE
fpos_t
size_t
二、小结 一、流 在C语言的标准库stdio.h中流stream是一个抽象的概念用于表示输入和输出流。在C语言中流是用来处理文件输入和输出的抽象实体它可以是标准输入流stdin、标准输出流stdout或者文件流file stream。 、、stdio.h中定义了一系列函数和宏来操作流例如fopen()用于打开文件流fclose()用于关闭文件流fread()和fwrite()用于读写文件流等。此外还有一些用于控制流的函数和宏如fflush()用于刷新输出缓冲区feof()和ferror()用于检查文件结束符和错误标志等。 通过使用流程序可以方便地进行文件的输入输出操作无论是从键盘读取输入还是向文件写入数据都可以通过流来实现。流的使用使得文件操作变得更加灵活和方便同时也提供了一种统一的接口来处理输入输出操作。 在程序运行时一般会使用以下三个流 stdin —— 标准输入流键盘stdout —— 标准输出流屏幕stderr —— 标准错误流屏幕 二、库函数
1、File access文件访问 fclose
用于关闭文件与流的联系
/* fclose example */
#include stdio.h
int main ()
{FILE * pFile;pFile fopen (myfile.txt,wt);fprintf (pFile, fclose example);fclose (pFile);//成功返回0失败返回EOFreturn 0;
} ----------------------------------------------------我是分割线-------------------------------------------------------------
fflush
在C语言中当你向文件写入数据时数据通常首先被存储在内存中的缓冲区中而不是立即写入文件。fflush函数可以强制将缓冲区中的数据写入文件以确保数据被及时保存。这在某些情况下特别重要比如在程序终止之前需要确保所有数据都已经写入文件时。
/* fflush example */
#include stdio.h
char mybuffer[80];
int main()
{FILE * pFile;pFile fopen (example.txt,r);if (pFile NULL) perror (Error opening file);else {fputs (test,pFile);fflush (pFile); // flushing or repositioning requiredfgets (mybuffer,80,pFile);puts (mybuffer);fclose (pFile);return 0;}
} ----------------------------------------------------我是分割线-------------------------------------------------------------
fopen
打开文件
FILE * fopen ( const char * filename, const char * mode ) 打开其名称在参数 filename 中指定的文件并将其与流相关联该流可在将来的操作中通过返回的 FILE 指针进行标识。文件名应该包含要打开的文件的名称的 C 字符串。其值应遵循运行环境的文件名规范。 对流执行的操作以及如何执行这些操作由 mode 参数定义。
以下为mode参数 返回值如果文件已成功打开该函数将返回指向 FILE 对象的指针该对象可用于在将来的操作中标识流。否则将返回 null 指针。
/* fopen example */
#include stdio.h
int main ()
{FILE * pFile;pFile fopen (myfile.txt,w);if (pFile!NULL){fputs (fopen example,pFile);fclose (pFile);}return 0;
} ----------------------------------------------------我是分割线-------------------------------------------------------------
freopen:
在C语言中freopen()函数用于重新指定一个已经打开的文件流的文件名和访问模式。这个函数可以用来重新定向一个已经打开的文件流从而改变该文件流对应的文件。
FILE * freopen ( const char * filename, const char * mode, FILE * stream ) filename要打开的文件名。mode打开方式同fopen。File一个FILE型指针可以是stdin(标准输入)或stdout(标准输出)。 使用freopen()函数可以实现一些文件操作的功能例如
重新打开一个文件从而关闭当前的文件流并将其重新指向另一个文件。改变文件流的访问模式例如从只读模式改为只写模式。 总之freopen()函数提供了一种方便的方式来重新指定一个已经打开的文件流从而改变其对应的文件和访问模式。 ----------------------------------------------------我是分割线-------------------------------------------------------------
setbuf :
用于为流指定缓冲区可以提高输入/输出操作的性能。该函数通常用于设置标准输入、标准输出或标准错误流的缓冲区。它接受三个参数正在设置缓冲区的流、指向缓冲区的指针和缓冲区的大小。setbuf函数对于优化输入/输出操作的性能特别有用特别是在处理大量数据时。
void setbuf ( FILE * stream, char * buffer ) FILE* stream指向标识打开流的 FILE 对象的指针 buffer 用户分配的缓冲区。长度至少为 BUFSIZ 字节。或者可以指定 null 指针来禁用缓冲。 /* setbuf example */
#include stdio.hint main ()
{char buffer[BUFSIZ];FILE *pFile1, *pFile2;pFile1fopen (myfile1.txt,w);pFile2fopen (myfile2.txt,a);setbuf ( pFile1 , buffer );fputs (This is sent to a buffered stream,pFile1);fflush (pFile1);setbuf ( pFile2 , NULL );fputs (This is sent to an unbuffered stream,pFile2);fclose (pFile1);fclose (pFile2);return 0;
} 在此示例中打开两个文件进行写入。与文件 myfile1.txt 关联的流设置为用户分配的缓冲区;对它执行写入操作;数据在逻辑上是流的一部分但在调用 fflush 函数之前它尚未写入设备。 示例中与文件 myfile2.txt 关联的第二个缓冲区设置为无缓冲因此后续输出操作将尽快写入设备。 但是一旦文件关闭缓冲流和无缓冲流的最终状态是相同的关闭文件会刷新其缓冲区。 ----------------------------------------------------我是分割线------------------------------------------------------------
setvbuf :
用于设置文件流的缓冲方式使用 setvbuf 可以控制文件流的缓冲行为这对于低级 I/O 或对性能有严格要求的程序非常有用。
int setvbuf ( FILE * stream, char * buffer, int mode, size_t size ) 参数说明 stream指向 FILE 对象的指针该 FILE 对象指定了要更改其缓冲区的流。buffer指向用户提供缓冲区的指针。如果这个参数是 NULL则库函数会为流自动分配一个缓冲区。mode指定缓冲区的模式。有效的模式有 _IONBF关闭缓冲。_IOFBF完全缓冲。_IOLBF行缓冲。size指定缓冲区的大小。如果该值为 0则库函数将使用一个实现定义的值。 详细mode 返回值如果成功函数返回 0否则返回一个非零值。
/* setvbuf example */#include stdio.hint main ()
{FILE *pFile;pFilefopen (myfile.txt,w);setvbuf ( pFile , NULL , _IOFBF , 1024 );// File operations herefclose (pFile);return 0;
} 在此示例中将创建一个名为 myfile.txt 的文件并为关联的流请求 1024 字节的完整缓冲区因此只有在每次填充 1024 字节缓冲区时才应将输出到此流的数据写入文件。 2、Operations on files对文件的操作 remove
删除文件
int remove ( const char * filename ); 参数说明 const char * filename文件名 返回值如果文件已成功删除则返回零值。失败时将返回非零值
#include stdio.hint main ()
{if( remove( myfile.txt ) ! 0 )perror( Error deleting file );elseputs( File successfully deleted );return 0;
}
----------------------------------------------------我是分割线------------------------------------------------------------ rename
将 oldname 指定的文件或目录的名称更改为 newname。
int rename ( const char * oldname, const char * newname );
返回值如果文件重命名成功则返回零值。失败时将返回非零值。
#include stdio.hint main ()
{int result;char oldname[] oldname.txt;char newname[] newname.txt;result rename( oldname , newname );if ( result 0 )puts ( File successfully renamed );elseperror( Error renaming file );return 0;
} ----------------------------------------------------我是分割线------------------------------------------------------------ tmofile
打开临时文件。创建一个临时二进制文件打开以供更新“wb”模式有关详细信息请参见 fopen其文件名保证与任何其他现有文件不同。当流关闭 fclose 或程序正常终止时创建的临时文件会自动删除。如果程序异常终止是否删除文件取决于具体的系统和库实现。
FILE * tmpfile ( void )返回值如果成功该函数将返回指向创建的临时文件的流指针。失败时返回 NULL。
#include stdio.h
#include string.hint main ()
{char buffer [256];FILE * pFile;pFile tmpfile ();do {if (!fgets(buffer,256,stdin)) break;fputs (buffer,pFile);} while (strlen(buffer)1);rewind(pFile);while (!feof(pFile)) {if (fgets (buffer,256,pFile) NULL) break;fputs (buffer,stdout);}fclose (pFile);return 0;
}
----------------------------------------------------我是分割线------------------------------------------------------------
tmpnam
生成临时文件名。返回一个字符串其中包含与任何现有文件的名称不同的文件名因此适合安全地创建临时文件而不会有覆盖现有文件的风险。
char * tmpnam ( char * str );参数 指向字符数组的指针其中建议的临时名称将存储为 C 字符串。此数组的建议大小至少为 L_tmpnam 个字符。或者可以指定一个 null 指针来使用内部静态数组来存储建议的临时名称其指针由函数返回。 返回值 成功后指向包含临时文件建议名称的 C 字符串的指针 如果 str 是 null 指针则指向内部缓冲区 其内容至少保留到下次调用此函数 。如果 str 不是 null 指针则返回 str。 如果函数无法创建合适的文件名它将返回一个 null 指针。 #include stdio.hint main ()
{char buffer [L_tmpnam];char * pointer;tmpnam (buffer);printf (Tempname #1: %s\n,buffer);pointer tmpnam (NULL);printf (Tempname #2: %s\n,pointer);return 0;
}
----------------------------------------------------我是分割线------------------------------------------------------------
3、Formatted input/output格式化的输入/输出 fprintf:
将按格式指向的 C 字符串写入流。如果 format 包含格式说明符以 % 开头的子序列则格式后面的附加参数将格式化并插入到生成的字符串中以替换它们各自的说明符。
int fprintf ( FILE * stream, const char * format, ... ); 参数 FILE*stream指向标识输出流的 FILE 对象的指针。 const char * format要输入的字符串类似printf可以在字符串中规定占位符 字符串后每个参数都包含一个值用于替换格式字符串中的格式说明符这些参数的数量至少应与格式说明符中指定的值数一样多。类似printf与字符串中的占位符对应具体请看举例理解。 返回值 成功后将返回写入的字符总数。 如果发生写入错误则设置错误指示符 ferror 并返回负数。 /* fprintf example */
#include stdio.hint main ()
{FILE * pFile;int n;char name [100];pFile fopen (myfile.txt,w);for (n0 ; n3 ; n){puts (please, enter a name: );gets (name);fprintf (pFile, Name %d [%-10.10s]\n,n1,name);}fclose (pFile);return 0;
}
----------------------------------------------------我是分割线------------------------------------------------------------
fscanf
从流中读取数据并根据参数格式将其存储到其他参数所指向的位置。
int fscanf ( FILE * stream, const char * format, ... ); stream:指向 FILE 对象的指针该对象标识要从中读取数据的输入流。 format格式说明符 附加参数用来与格式说明符对应只不过这些参数应该是指针用于对该地值进行输入。 返回值 成功后该函数返回成功填充的参数列表的项数。 失败返回EOF /* fscanf example */
#include stdio.hint 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;
}
----------------------------------------------------我是分割线------------------------------------------------------------
snprintf :
将C 字符串存储在 s 指向的缓冲区中将 n 作为要填充的最大缓冲区容量。
int snprintf ( char * s, size_t n, const char * format, ... ); s,n : s为要写入的字符串n为要写入的字符的最大数目超过n会被截断因为读取要包括‘\0’所以实际读入为n - 1个 format : 格式化字符串包含的格式字符串遵循与 printf 中的格式相同的规范 ...写入对应占位符的字符串或其他类型数据 类似该格式snprintf(str, 3, %s, abcdefg) 返回值 正常返回值为字符串中字符数量不包括NULL 编码错误返回负数。 /* snprintf example */
#include stdio.hint main ()
{char buffer [100];int cx;cx snprintf ( buffer, 100, The half of %d is %d, 60, 60/2 );if (cx0 cx100) // check returned valuesnprintf ( buffercx, 100-cx, , and the half of that is %d., 60/2/2 );puts (buffer);return 0;
} 输出The half of 60 is 30, and the half of that is 15. ----------------------------------------------------我是分割线------------------------------------------------------------ sprintf
功能与snprintf相似但是没有snprintf安全。
int sprintf ( char * str, const char * format, ... ); 参数 str指向存储生成的 C 字符串的缓冲区的指针。缓冲区应足够大以包含生成的字符串。 formatC 字符串其中包含的格式字符串遵循与 printf 中的格式相同的规范 ...根据格式字符串后跟随替换占位符的参数 返回值 成功后返回写入的字符总数。此计数不包括自动追加在字符串末尾的附加 null 字符。 失败时返回负数。 /* sprintf example */
#include stdio.hint main ()
{char buffer [50];int n, a5, b3;nsprintf (buffer, %d plus %d is %d, a, b, ab);printf ([%s] is a string %d chars long\n,buffer,n);return 0;
} [5 plus 3 is 8] is a string 13 chars long----------------------------------------------------我是分割线------------------------------------------------------------
sscanf
从字符串中读取格式化数据从 s 读取数据并根据参数格式将它们存储到附加参数给出的位置就像使用 scanf 一样但从 s 读取数据而不是标准输入 stdin。
int sscanf ( const char * s, const char * format, ...); 参数 s从该字符串中读取数据 formatC 字符串其中包含的格式字符串该字符串遵循与 scanf 中的格式相同的规范 ...后跟参数对应格式字符串作为指针对应占位符 返回值 成功该函数返回参数列表中成功填充的项数。 如果在成功解释任何数据之前输入失败则返回 EOF。 /* sscanf example */
#include stdio.hint main ()
{char sentence []Rudolph is 12 years old;char str [20];int i;sscanf (sentence,%s %*s %d,str,i);//添加了*的部分会被忽略,不会被参数获取printf (%s - %d\n,str,i);return 0;
} 输出Rudolph - 12 ----------------------------------------------------我是分割线------------------------------------------------------------
vfprintf
将格式化数据从变量参数列表写入流
int vfprintf ( FILE * stream, const char * format, va_list arg ); 参数 stream指向标识输出流的 FILE 对象的指针。 fomatC 字符串含占位符 arg 在 vfprintf 函数中va_list 类型用于访问参数列表中的各个参数。va_list 实际上是一个简单的类型定义通常定义为 typedef int va_list它只是一个整数类型的别名用于在参数列表中进行偏移计算。 使用 vfprintf 函数时通常需要结合 va_start、va_arg 和 va_end 宏来正确地处理可变参数列表。这些宏用于初始化 va_list 变量、获取参数列表中的下一个参数以及清理 va_list 变量它们通常在 stdarg.h 头文件中定义。 vfprintf 函数根据 format 字符串和 ap参数列表的内容将格式化的数据写入到 stream 指向的文件中。如果函数成功执行它将返回写入的字符数。如果出现错误它将返回一个负值。 这个函数通常与 stdio.h 和 stdarg.h 头文件一起使用 返回值 成功将返回写入的字符总数。 错误设置错误指示符 ferror 并返回负数。 /* vfprintf example */
#include stdio.h
#include stdarg.hvoid WriteFormatted (FILE * stream, const char * format, ...)
{va_list args;va_start (args, format);vfprintf (stream, format, args);va_end (args);
}int main ()
{FILE * pFile;pFile fopen (myfile.txt,w);WriteFormatted (pFile,Call with %d variable argument.\n,1);WriteFormatted (pFile,Call with %d variable %s.\n,2,arguments);fclose (pFile);return 0;
} myfile.txt将包含 我的文件.txt Call with 1 variable argument. Call with 2 variable arguments. ----------------------------------------------------我是分割线------------------------------------------------------------
vfscanf
将格式化数据从流读取到变量参数列表中从流中读取数据并根据参数格式将它们存储到 arg 标识的变量参数列表中元素所指向的位置。
int vfscanf ( FILE * stream, const char * format, va_list arg ); stream指向标识输入流的 FILE 对象的指针。 formatC 字符串其中包含的格式字符串 arg标识使用va_start初始化的变量参数列表的值。va_list是在cstdarg中定义的特殊类型。 成功该函数返回成功填充的参数列表的项数。此计数可以与预期的项目数匹配也可以由于匹配失败、读取错误或文件末尾的范围而更少甚至为零。 如果读取时发生读取错误或到达文件末尾则设置正确的指示器feof 或 ferror。而且如果在成功读取任何数据之前发生任何一种情况则返回 EOF。 /* vfscanf example */
#include stdio.h
#include stdarg.hvoid ReadStuff (FILE * stream, const char * format, ...)
{va_list args;va_start (args, format);vfscanf (stream, format, args);va_end (args);
}int main ()
{FILE * pFile;int val;char str[100];pFile fopen (myfile.txt,r);if (pFile!NULL) {ReadStuff ( pFile, %s %d , str, val );printf (I have read %s and %d, str, val);fclose (pFile);}return 0;
}
----------------------------------------------------我是分割线------------------------------------------------------------
vprintf
将格式化数据从变量参数列表打印到 stdout将 format 指向的 C 字符串写入标准输出 stdout以与 printf 相同的方式替换任何格式说明符但使用 arg 标识的变量参数列表中的元素而不是其他函数参数。
int vprintf ( const char * format, va_list arg ); 参数 formatC 字符串其中包含的格式字符串遵循与 printf 中的格式相同的规范 arg标识使用 va_start 初始化的变量参数列表的值。va_list 是 cstdarg 中定义的特殊类型。 之后文章会对va_list进行详细介绍 返回值 成功将返回写入的字符总数。 发生写入错误则设置错误指示符 ferror 并返回负数。 /* vprintf example */
#include stdio.h
#include stdarg.hvoid WriteFormatted ( const char * format, ... )
{va_list args;va_start (args, format);vprintf (format, args);va_end (args);
}int main ()
{WriteFormatted (Call with %d variable argument.\n,1);WriteFormatted (Call with %d variable %s.\n,2,arguments);return 0;
} 该示例演示如何使用不同数量的参数调用 WriteFormatted这些参数又传递给 vprintf 函数显示以下输出 Call with 1 variable argument.
Call with 2 variable arguments. ----------------------------------------------------我是分割线------------------------------------------------------------
vscanf
将格式化数据读入变量参数列表从标准输入 stdin 读取数据并根据参数格式将其存储到由 arg 标识的变量参数列表中的元素所指向的位置。
int vscanf ( const char * format, va_list arg ) 参数 formatC 字符串其中包含的格式字符串该字符串遵循与 scanf 中的格式相同的规范 返回值 arg之后会发布对arg进行详细讲解文章 /* vscanf example */
#include stdio.h
#include stdarg.hvoid GetMatches ( const char * format, ... )
{va_list args;va_start (args, format);vscanf (format, args);va_end (args);
}int main ()
{int val;char str[100];printf (Please enter a number and a word: );fflush (stdout);GetMatches ( %d %99s , val, str);printf (Number read: %d\nWord read: %s\n, val, str);return 0;
} Please enter a number and a word: 911 airport
Number read: 911
Word read: airport ----------------------------------------------------我是分割线------------------------------------------------------------
vsnprintf
将格式化数据从变量参数列表写入大小缓冲区使用在 printf 上使用 format 时打印的相同文本组成一个字符串但使用 arg 标识的变量参数列表中的元素而不是其他函数参数并将生成的内容作为 C 字符串存储在由 s 指向的缓冲区中将 n 作为要填充的最大缓冲区容量。
int vsnprintf (char * s, size_t n, const char * format, va_list arg ); 参数 s指向存储生成的 C 字符串的缓冲区的指针。缓冲区的大小应至少为 n 个字符。 n缓冲区中要使用的最大字节数。生成的字符串的长度最多为 n-1为其他终止 null 字符留出空间。 formatC 字符串其中包含的格式字符串遵循与 printf 中的格式相同的规范 arg之后文章介绍 返回值 如果足够大则将写入的字符数不包括终止的 null 字符。 如果发生编码错误则返回负数。 /* vsnprintf example */
#include stdio.h
#include stdarg.hvoid PrintFError ( const char * format, ... )
{char buffer[256];va_list args;va_start (args, format);vsnprintf (buffer,256,format, args);perror (buffer);va_end (args);
}int main ()
{FILE * pFile;char szFileName[]myfile.txt;pFile fopen (szFileName,r);if (pFile NULL)PrintFError (Error opening %s,szFileName);else{// file successfully openfclose (pFile);}return 0;
} 如果文件 myfile.txt 不存在则调用 perror 以显示类似于以下内容的错误消息 Error opening file myfile.txt: No such file or directory----------------------------------------------------我是分割线------------------------------------------------------------
vsprintf
将格式化数据从变量参数列表写入字符串,使用在 printf 上使用 format 时打印的相同文本组成一个字符串但使用 arg 标识的变量参数列表中的元素而不是其他函数参数并将生成的内容作为 C 字符串存储在 s 指向的缓冲区中。
int vsprintf (char * s, const char * format, va_list arg ); 参数 s指向存储生成的 C 字符串的缓冲区的指针。 formatC 字符串其中包含的格式字符串遵循与 printf 中的格式相同的规范 arg后文再做解释 返回值 成功后将返回写入的字符总数。 失败时返回负数。 /* vsprintf example */
#include stdio.h
#include stdarg.hvoid PrintFError ( const char * format, ... )
{char buffer[256];va_list args;va_start (args, format);vsprintf (buffer,format, args);perror (buffer);va_end (args);
}int main ()
{FILE * pFile;char szFileName[]myfile.txt;pFile fopen (szFileName,r);if (pFile NULL)PrintFError (Error opening %s,szFileName);else{// file successfully openfclose (pFile);}return 0;
} 如果文件 myfile.txt 不存在则调用 perror 以显示类似于以下内容的错误消息 Error opening file myfile.txt: No such file or directory----------------------------------------------------我是分割线------------------------------------------------------------
vsscanf
将格式化数据从字符串读取到变量参数列表中从 s 读取数据并根据参数格式将它们存储到 arg 标识的变量参数列表中元素所指向的位置。
int vsscanf ( const char * s, const char * format, va_list arg ); s函数作为其源处理以检索数据的 C 字符串。 formatC 字符串其中包含的格式字符串该字符串遵循与 scanf 中的格式相同的规范 arg后文讲解 成功返回参数列表中成功填充的项数。 在成功解释任何数据之前输入失败返回 EOF。 /* vsscanf example */
#include stdio.h
#include stdarg.hvoid GetMatches ( const char * str, const char * format, ... )
{va_list args;va_start (args, format);vsscanf (str, format, args);va_end (args);
}int main ()
{int val;char buf[100];GetMatches ( 99 bottles of beer on the wall, %d %s , val, buf);printf (Product: %s\nQuantity: %d\n, buf, val);return 0;
} Product: bottles
Quantity: 99 ----------------------------------------------------我是分割线------------------------------------------------------------
4、Character input/output:字符输入/输出 fgetc
从流中获取字符。
int fgetc ( FILE * stream ); 返回值 成功将返回读取的字符提升为 int 值 失败EOF /* fgetc example: money counter */
#include stdio.h
int main ()
{FILE * pFile;int c;int n 0;pFilefopen (myfile.txt,r);if (pFileNULL) perror (Error opening file);else{do {c fgetc (pFile);if (c $) n;} while (c ! EOF);fclose (pFile);printf (The file contains %d dollar sign characters ($).\n,n);}return 0;
} 逐个字符读取名为 myfile.txt 的现有文件并使用 n 变量来计算文件包含的美元字符数 $。 ----------------------------------------------------我是分割线------------------------------------------------------------
fgets
从流中获取字符串。
char * fgets ( char * str, int num, FILE * stream ); 规则 从流中读取字符并将它们作为 C 字符串存储到 str 中直到读取 num-1 个字符或到达换行符或文件末尾以先到者为准。换行符使 fgets 停止读取但它被函数视为有效字符并包含在复制到 str 的字符串中。终止 null 字符会自动追加到复制到 str 的字符之后。 fgets 与 gets 有很大不同fgets 不仅接受 stream 参数还允许指定 str 的最大大小并在字符串中包含任何结束换行符。 参数 str指向复制字符串读取的 chars 数组的指针。 num要复制到 str 中的最大字符数包括终止 null 字符。 stream指向标识输入流的 FILE 对象的指针。stdin可以用作从标准输入中读取的参数 返回值 成功该函数返回 str 失败返回NULL /* fgets example */
#include stdio.hint main()
{FILE * pFile;char mystring [100];pFile fopen (myfile.txt , r);if (pFile NULL) perror (Error opening file);else {if ( fgets (mystring , 100 , pFile) ! NULL )puts (mystring);fclose (pFile);}return 0;
} 读取 myfile.txt 的第一行或前 99 个字符以先到者为准并将其打印在屏幕上。 ----------------------------------------------------我是分割线------------------------------------------------------------ fputc
将字符写入流。
int fputc ( int character, FILE * stream ); 参数 character要编写的字符的 int 提升符号提升。写入时该值在内部转换为无符号字符。 stream指向标识输出流的 FILE 对象的指针。 返回值 成功功返回所写的字符。 错误返回 EOF 并设置错误指示符 ferror。 /* fputc example: alphabet writer */
#include stdio.hint main ()
{FILE * pFile;char c;pFile fopen (alphabet.txt,w);if (pFile!NULL) {for (c A ; c Z ; c)fputc ( c , pFile );fclose (pFile);}return 0;
} 创建一个名为 alphabet.txt 的文件并将 ABCDEFGHIJKLMNOPQRSTUVWXYZ 写入其中。 ----------------------------------------------------我是分割线------------------------------------------------------------
fputs
将字符串写入流。
int fputs ( const char * str, FILE * stream ); 规则和跟puts的不同处 将 str 指向的 C 字符串写入流。 该函数从指定的地址 str 开始复制直到到达终止 null 字符 \0。此终止 null 字符不会复制到流中。 请注意fputs 与 put 的不同之处不仅在于可以指定目标流而且 fputs 不会写入其他字符而 puts 会自动在末尾附加换行符。 参数 str包含要写入流的内容的 C 字符串。 stream指向标识输出流的 FILE 对象的指针。 返回值 成功返回非负值。 错误该函数返回 EOF 并设置错误指示器 ferror。 /* fputs example */
#include stdio.hint main ()
{FILE * pFile;char sentence [256];printf (Enter sentence to append: );fgets (sentence,256,stdin);pFile fopen (mylog.txt,a);fputs (sentence,pFile);fclose (pFile);return 0;
} 该程序允许在每次运行时将一行附加到名为 mylog.txt 的文件中。 ----------------------------------------------------我是分割线------------------------------------------------------------
getc
从流中获取字符
int getc ( FILE * stream ); 规则 返回指定流的内部文件位置指示器当前指向的字符。然后内部文件位置指示器将前进到下一个字符。如果流在调用时位于文件末尾则该函数将返回 EOF 并设置流的文件末尾指示符 feof。如果发生读取错误该函数将返回 EOF 并设置流的错误指示器 ferror。getc 和 fgetc 是等效的只是 getc 在某些库中可以作为宏实现。 参数 stream指向标识输入流的 FILE 对象的指针。 返回值 成功后将返回读取的字符提升为 int 值。 返回类型为 int 以适应特殊值 EOF该值表示失败 如果位置指示器位于文件末尾则该函数返回 EOF 并设置流的 EOF 指示器 feof。 如果发生其他读取错误该函数也会返回 EOF但会设置其错误指示器 ferror。 /* getc example: money counter */
#include stdio.h
int main ()
{FILE * pFile;int c;int n 0;pFilefopen (myfile.txt,r);if (pFileNULL) perror (Error opening file);else{do {c getc (pFile);if (c $) n;} while (c ! EOF);fclose (pFile);printf (File contains %d$.\n,n);}return 0;
} 逐个字符读取名为 myfile.txt 的现有文件并使用 n 变量来计算文件包含多少美元字符 $。 ----------------------------------------------------我是分割线------------------------------------------------------------ getchar
从 stdin 获取字符返回读取的字符。
int getchar ( void ); 等效于使用 stdin 作为参数调用 getc 返回值 成功返回读取的字符提升为 int 值。 失败EOF /* getchar example : typewriter */
#include stdio.hint main ()
{int c;puts (Enter text. Include a dot (.) in a sentence to exit:);do {cgetchar();putchar (c);} while (c ! .);return 0;
} 一台简单的打字机。一旦按下 ENTER每个句子都会被回显直到文本中包含一个点 . ----------------------------------------------------我是分割线------------------------------------------------------------
gets
从 stdin 获取字符串返回获取的字符串终止 null 字符会自动追加到复制到 str 的字符之后
char * gets ( char * str );
[注意此函数在 C 或 C 中不再可用从 C11 和 C14 开始] 参数 str指向内存块字符数组的指针其中读取的字符串被复制为 C 字符串。 返回值 成功函数返回 str。 失败返回空指针。 /* gets example */
#include stdio.hint main()
{char string [256];printf (Insert your full address: );gets (string); // warning: unsafe (see fgets instead)printf (Your address is: %s\n,string);return 0;
}
----------------------------------------------------我是分割线------------------------------------------------------------
putc
将字符写入流字符被写在流的内部位置指示器指示的位置然后自动前进一个
int putc ( int character, FILE * stream ); 参数 character要写入的字符写入时该值在内部转换为无符号字符。 stream指向标识输出流的 FILE 对象的指针。 返回值 成功返回所写的字符。 错误返回 EOF 并设置错误指示符 ferror。 /* putc example: alphabet writer */
#include stdio.hint main ()
{FILE * pFile;char c;pFilefopen(alphabet.txt,wt);for (c A ; c Z ; c) {putc (c , pFile);}fclose (pFile);return 0;
} 示例程序创建一个名为 alphabet.txt 的文件并将 ABCDEFGHIJKLMNOPQRSTUVWXYZ 写入其中。 ----------------------------------------------------我是分割线------------------------------------------------------------
putchar:
将字符写入 stdout等价于使用 stdout 作为第二个参数调用 putc
int putchar ( int character ); 参数 character要编写的字符的 int 提升写入时该值在内部转换为无符号字符。 返回值 成功返回所写的字符。 错误返回 EOF 并设置错误指示符 ferror。 /* putchar example: printing the alphabet */
#include stdio.hint main ()
{char c;for (c A ; c Z ; c) putchar (c);return 0;
} 此程序将 ABCDEFGHIJKLMNOPQRSTUVWXYZ 写入标准输出。 ----------------------------------------------------我是分割线------------------------------------------------------------
puts
将字符串写入 stdout
int puts ( const char * str ); 规则 将 str 指向的 C 字符串写入标准输出 stdout 并附加换行符 \n。 该函数从指定的地址 str 开始复制直到到达终止 null 字符 \0。此终止 null 字符不会复制到流中。 请注意put 不仅与 fputs 的不同之处在于它使用 stdout 作为目标而且还会自动在末尾附加一个换行符fputs 不会。 参数 str要打印的 C 字符串。 返回值 成功返回非负值。 错误返回 EOF 并设置错误指示器 ferror。 /* puts example : hello world! */
#include stdio.hint main ()
{char string [] Hello world!;puts (string);
}
----------------------------------------------------我是分割线------------------------------------------------------------
ungetc
从流中取消获取字符
int ungetc(int c, FILE *stream); 功能ungetc函数的作用是将指定的字符c推送回输入流stream中。推送回的字符会成为下一次读取的第一个字符即使它已经被读取过。 参数 c是要推送回输入流的字符通常是一个unsigned char类型的值。stream是指向FILE结构的指针表示要进行操作的文件流。 返回值 成功返回推送回的字符 失败返回EOF 注意事项 一般来说ungetc函数只能将一个字符推送回输入流。如果需要推送回多个字符可以多次调用ungetc函数。ungetc函数只能在读取之前调用即在调用任何输入函数如fgetc、fgets等之前调用。ungetc函数通常用于实现简单的词法分析器以便在读取字符后发现它不属于当前词法单元时将字符推送回输入流 /* ungetc example */
#include stdio.hint main ()
{FILE * pFile;int c;char buffer [256];pFile fopen (myfile.txt,rt);if (pFileNULL) perror (Error opening file);else while (!feof (pFile)) {cgetc (pFile);if (c EOF) break;if (c #) ungetc (,pFile);else ungetc (c,pFile);if (fgets (buffer,255,pFile) ! NULL)fputs (buffer,stdout);else break;}return 0;
} 打开一个名为 myfile.txt 的现有文件进行读取并打印其行但首先获取每行的第一个字符并将其放回流中将任何起始 # 替换为 。 ----------------------------------------------------我是分割线------------------------------------------------------------
5、Direct input/output直接输入/输出 fread
从流中读取 count 元素的数组每个元素的大小为 bytes并将它们存储在 ptr 指定的内存块中。
size_t fread ( void * ptr, size_t size, size_t count, FILE * stream ); 参数 ptr指向大小至少为 size*count 字节的内存块的指针转换为 void*。 size要读取的每个元素的大小以字节为单位。 count元素数每个元素的大小为字节。 stream指向指定输入流的 FILE 对象的指针。 返回值 成功返回成功读取的元素总数。 如果 size 或 count 为零则该函数返回零并且 ptr 指向的流状态和内容保持不变。 /* fread example: read an entire file */
#include stdio.h
#include stdlib.hint main () {FILE * pFile;long lSize;char * buffer;size_t result;pFile fopen ( myfile.bin , rb );if (pFileNULL) {fputs (File error,stderr); exit (1);}// obtain file size:fseek (pFile , 0 , SEEK_END);lSize ftell (pFile);rewind (pFile);// allocate memory to contain the whole file:buffer (char*) malloc (sizeof(char)*lSize);if (buffer NULL) {fputs (Memory error,stderr); exit (2);}// copy the file into the buffer:result fread (buffer,1,lSize,pFile);if (result ! lSize) {fputs (Reading error,stderr); exit (3);}/* the whole file is now loaded in the memory buffer. */// terminatefclose (pFile);free (buffer);return 0;
} 将 myfile.bin 加载到动态分配的内存缓冲区中该缓冲区可用于将文件的内容作为数组进行操作。
----------------------------------------------------我是分割线------------------------------------------------------------
fwrite
从 ptr 指向的内存块写入一个 count 元素数组每个元素的大小为 Bytes 字节。
size_t fwrite ( const void * ptr, size_t size, size_t count, FILE * stream ); 参数 ptr指向要写入的元素数组的指针。 size要写入的每个元素的大小以字节为单位。 count元素数每个元素的大小为字节。 stream指向指定输出流的 FILE 对象的指针。 返回值 成功返回成功写入的元素总数。 如果此数字与 count 参数不同则表示写入错误阻止了函数完成。在这种情况下将为流设置错误指示器 ferror。 如果 size 或 count 为零则函数返回零错误指示器保持不变。 /* fwrite example : write buffer */
#include stdio.hint main ()
{FILE * pFile;char buffer[] { x , y , z };pFile fopen (myfile.bin, wb);fwrite (buffer , sizeof(char), sizeof(buffer), pFile);fclose (pFile);return 0;
}
创建一个名为 myfile.bin 的文件并将缓冲区的内容存储到其中。char类型元素是1字节所以直接用sizeof计算得到的就是数组的大小。 6、Error-handling错误处理 clearerr
清除错误指示器。
void clearerr ( FILE * stream ); 参数 stream指向标识流的 FILE 对象的指针。 #include stdio.hint main() {FILE *pFile;pFile fopen(myfile.txt, r); // 尝试以只读方式打开文件if (pFile NULL) {perror(Error opening file); // 如果打开文件失败输出错误信息} else {fputc(x, pFile); // 向文件中写入字符 xif (ferror(pFile)) {printf(Error Writing to myfile.txt\n); // 如果写入文件时发生错误输出错误信息clearerr(pFile); // 清除文件错误标志}fgetc(pFile); // 从文件中读取一个字符if (!ferror(pFile)) {printf(No errors reading myfile.txt\n); // 如果读取文件时没有发生错误输出成功信息}fclose(pFile); // 关闭文件}return 0;
}
程序打开一个名为 myfile.txt 的现有文件进行读取并导致尝试在其上写入时出现 I/O 错误。使用 clearerr 清除该错误因此第二次错误检查返回 false。这段代码主要演示了文件操作中的错误处理方式包括文件打开失败的处理、写入错误的处理、读取错误的处理以及关闭文件。 输出结果 Error Writing to myfile.txt No errors reading myfile.txt 代码解析 FILE *pFile; 声明了一个指向文件的指针 pFile。pFile fopen(myfile.txt, r); 尝试以只读方式打开名为 myfile.txt 的文件。如果打开失败fopen 函数将返回 NULL表示文件打开失败。if (pFile NULL) { perror(Error opening file); } 如果文件打开失败即 pFile 为 NULL则输出错误信息使用 perror 函数输出系统错误信息。如果文件成功打开程序会尝试向文件中写入字符 x然后检查是否有写入错误发生。如果有错误发生输出错误信息并清除文件错误标志。然后程序尝试从文件中读取一个字符并检查是否有读取错误发生。如果没有错误发生输出成功信息。最后无论是否发生错误都会关闭文件。 ----------------------------------------------------我是分割线------------------------------------------------------------
feof
检查是否设置了与流关联的文件结束指示符如果设置了则返回与零不同的值。
int feof ( FILE * stream ); 参数 stream指向标识流的 FILE 对象的指针。 返回值 如果 feof 返回 0表示文件流的结束标志尚未设置即文件流未到达文件末尾。如果 feof 返回非零值表示文件流的结束标志已经设置即文件流已经到达了文件末尾。 /* feof example: byte counter */
#include stdio.hint main ()
{FILE * pFile;int n 0;pFile fopen (myfile.txt,rb);if (pFileNULL) perror (Error opening file);else{while (fgetc(pFile) ! EOF) {n;}if (feof(pFile)) {puts (End-of-File reached.);printf (Total number of bytes read: %d\n, n);}else puts (End-of-File was not reached.);fclose (pFile);}return 0;
}
该程序中打开名为 myfile.txt 的文件并通过逐个读取所有字符来计算它包含的字符数。程序检查是否已到达文件末尾如果是则打印读取的总字节数。
----------------------------------------------------我是分割线------------------------------------------------------------
ferror
检查是否设置了与流关联的错误指示器如果设置了则返回与零不同的值。通常由对失败的流的先前操作设置并通过调用 clearerr、rewind 或 freopen 来清除。
ferror 函数用于检查文件流的错误标志。在 C 语言中文件流通常是通过 FILE 结构指针进行操作的。ferror 函数的返回值表示了文件流的错误标志 参数 stream指向标识流的 FILE 对象的指针。 返回值 如果 ferror 返回 0表示文件流的错误标志尚未设置即文件操作未发生错误。如果 ferror 返回非零值表示文件流的错误标志已经设置即文件操作发生了错误。 /* ferror example: writing error */
#include stdio.h
int main ()
{FILE * pFile;pFilefopen(myfile.txt,r);if (pFileNULL) perror (Error opening file);else {fputc (x,pFile);if (ferror (pFile))printf (Error Writing to myfile.txt\n);fclose (pFile);}return 0;
}
尝试打开一个名为 myfile.txt 的文件并向文件中写入字符 x。然后使用 ferror 函数来检查文件流的错误标志以确定文件操作是否发生了错误。如果发生了错误则输出相应的错误信息。最后关闭文件并返回 0。
这段代码的作用是尝试向只读模式打开的文件中写入数据这是一个错误的操作。因为文件以只读模式打开所以写入操作会失败ferror 函数会检测到错误并输出相应的错误信息。
下面是对该代码的详细讲解 FILE * pFile; - 声明了一个指向 FILE 结构的指针 pFile。pFilefopen(myfile.txt,r); - 尝试以只读模式打开名为 myfile.txt 的文件。如果打开失败使用 perror 函数输出错误信息。fputc (x,pFile); - 向文件中写入字符 x。if (ferror (pFile)) printf (Error Writing to myfile.txt\n); - 使用 ferror 函数检查文件流的错误标志如果发生了错误则输出相应的错误信息。fclose (pFile); - 关闭文件。返回 0。 ----------------------------------------------------我是分割线------------------------------------------------------------
perror
打印错误消息将 errno 的值解释为错误消息并将其打印到 stderr标准错误输出流通常是控制台如果参数 str 不是空指针则打印 str后跟冒号 :) 和空格。然后无论 str 是否为 null 指针都会打印生成的错误描述后跟换行符 \n。 perror 应在产生错误后立即调用否则可能会被调用其他函数覆盖。
void perror ( const char * str ); 参数 C 字符串包含要在错误消息本身之前打印的自定义消息。 如果是 null 指针则不会打印前面的自定义消息但仍会打印错误消息。 按照惯例应用程序本身的名称通常用作参数。 /* perror example */
#include stdio.hint main ()
{FILE * pFile;pFilefopen (unexist.ent,rb);if (pFileNULL)perror (The following error occurred);elsefclose (pFile);return 0;
} 如果文件 unexist.ent 不存在则程序输出可能会有类似的东西 The following error occurred: No such file or directory7、Types类型 FILE
FILE 类型是 C 语言中用于表示文件流的结构类型。它通常用于打开、读取、写入和关闭文件。FILE 类型是通过 stdio.h 头文件定义的它提供了一组函数来操作文件流。
以下是一个简单的例子演示了如何使用 FILE 类型来打开、读取和关闭文件
#include stdio.hint main() {FILE *pFile;char buffer[100];pFile fopen(example.txt, r); // 以只读模式打开文件if (pFile NULL) {perror(Error opening file);} else {if (fgets(buffer, 100, pFile) ! NULL) { // 从文件中读取内容到 bufferprintf(Read from file: %s, buffer);} else {perror(Error reading from file);}fclose(pFile); // 关闭文件}return 0;
}
我们首先声明了一个 FILE 类型的指针 pFile用于表示文件流。然后使用 fopen 函数以只读模式打开名为 example.txt 的文件如果打开失败则输出错误信息。接着使用 fgets 函数从文件中读取内容到 buffer并输出到控制台。最后使用 fclose 函数关闭文件。 作用小结 FILE 类型提供了一种方便的方式来处理文件流它允许我们进行文件的打开、读取、写入和关闭等操作。 ----------------------------------------------------我是分割线------------------------------------------------------------
fpos_t
fpos_t 是 C 语言标准库中用来表示文件位置的类型。它通常用于存储文件流的位置并且可以在文件的定位和操作中使用。
fpos_t 类型的具体实现可能因平台而异但通常是一个结构或者整数类型。
#include stdio.hint main() {FILE *pFile;fpos_t position;pFile fopen(example.txt, r); // 以只读模式打开文件if (pFile NULL) {perror(Error opening file);} else {fgetpos(pFile, position); // 获取当前文件位置printf(Current position: %lld\n, (long long)position);fseek(pFile, 10, SEEK_SET); // 设置文件位置到偏移量为 10 的位置fgetpos(pFile, position); // 获取新的文件位置printf(New position: %lld\n, (long long)position);fclose(pFile); // 关闭文件}return 0;
}
在这个例子中我们首先声明了一个 fpos_t 类型的变量 position用于存储文件位置。然后使用 fopen 函数以只读模式打开名为 example.txt 的文件如果打开失败则输出错误信息。接着使用 fgetpos 函数获取当前文件位置并输出到控制台。然后使用 fseek 函数将文件位置设置到偏移量为 10 的位置并再次使用 fgetpos 函数获取新的文件位置并输出到控制台。最后使用 fclose 函数关闭文件。
----------------------------------------------------我是分割线------------------------------------------------------------
size_t
无符号整形的别名相当于unsigned int 。 二、小结
在本篇博客中我们深入探讨了 stdio.h 头文件在 C 语言中的重要性以及它所提供的丰富功能。我们首先介绍了该头文件中定义的一些常见函数例如 fopen、fclose、fread、fwrite 等这些函数为我们提供了对文件的打开、关闭、读取和写入等操作。接着我们讨论了 FILE 类型和 fpos_t 类型它们分别用于表示文件流和文件位置为我们在文件操作中提供了更多的灵活性和控制。
通过本篇博客的学习我们不仅对 stdio.h 头文件有了更深入的了解还学会了如何使用它提供的函数和类型来进行文件的操作。文件操作在实际的编程工作中是非常常见的因此对于 stdio.h 头文件的掌握将有助于我们更好地处理文件相关的任务。
希望本篇博客能够帮助读者更好地理解 stdio.h 头文件并在日后的编程工作中能够更加熟练地运用其中提供的函数和类型。关于stdio.h中关于C语言中的宏定义将会在之后的文章进行讲解。如果你有任何关于 C 语言文件操作或者其他编程相关的问题都可以随时留言交流。感谢阅读
