函数FILE * fopen(const char * path,const char * mode);

函数功能：打开一个文件

函数原型：FILE * fopen(const char * path,const char * mode);

相关函数：open，fclose，fopen_s[1]，_wfopen

所需库：<stdio.h>

返回值：文件顺利打开后，指向该流的文件指针就会被返回。如果文件打开失败则返回NULL，并把错误代码存在errno 中。

一般而言，打开文件后会作一些文件读取或写入的动作，若打开文件失败，接下来的读写动作也无法顺利进行，所以一般在fopen()后作错误判断及处理。

参数说明：

参数path字符串包含欲打开的文件路径及文件名，参数mode字符串则代表着流形态。

mode有下列几种形态字符串:

r 以只读方式打开文件，该文件必须存在。

r+ 以可读写方式打开文件，该文件必须存在。

rb+ 读写打开一个二进制文件，允许读写数据。

rw+ 读写打开一个文本文件，允许读和写。

w 打开只写文件，若文件存在则文件长度清为0，即该文件内容会消失。若文件不存在则建立该文件。

w+ 打开可读写文件，若文件存在则文件长度清为零，即该文件内容会消失。若文件不存在则建立该文件。

a 以附加的方式打开只写文件。若文件不存在，则会建立该文件，如果文件存在，写入的数据会被加到文件尾，即文件原先的内容会被保留。（EOF符保留）

a+ 以附加方式打开可读写的文件。若文件不存在，则会建立该文件，如果文件存在，写入的数据会被加到文件尾后，即文件原先的内容会被保留。 （原来的EOF符不保留）

wb 只写打开或新建一个二进制文件；只允许写数据。

wb+ 读写打开或建立一个二进制文件，允许读和写。

ab+ 读写打开一个二进制文件，允许读或在文件末追加数据。

at+ 打开一个叫string的文件，a表示append,就是说写入处理的时候是接着原来文件已有内容写入，不是从头写入覆盖掉，t表示打开文件的类型是文本文件，+号表示对文件既可以读也可以写。

上述的形态字符串都可以再加一个b字符，如rb、w+b或ab+等组合，加入b 字符用来告诉函数库以二进制模式打开文件。如果不加b，表示默认加了t，即rt,wt,其中t表示以文本模式打开文件。由fopen()所建立的新文件会具有S_IRUSR|S_IWUSR|S_IRGRP|S_IWGRP|S_IROTH|S_IWOTH(0666)权限，此文件权限也会参考umask 值。

有些C编译系统可能不完全提供所有这些功能，有的C版本不用"r+","w+","a+",而用"rw","wr","ar"等，读者注意所用系统的规定。

二进制和文本模式的区别

1.在windows系统中，文本模式下，文件以""代表换行。若以文本模式打开文件，并用fputs等函数写入换行符"\n"时，函数会自动在"\n"前面加上"\r"。即实际写入文件的是"" 。

2.在类Unix/Linux系统中文本模式下，文件以"\n"代表换行。所以Linux系统中在文本模式和二进制模式下并无区别。


函数原型：size_t fread ( void   *buffer,  size_t size,  size_t count,  FILE *stream) ;

功 能：

从一个文件流中读数据，最多读取count个元素，每个元素size字节，如果调用成功返回实际读取到的元素个数，如果不成功返回 0。

参 数：

buffer

用于接收数据的内存地址,大小至少是size*count字节.

size

单个元素的大小，单位是字节

count

元素的个数,每个元素是size字节.

stream

输入流

返回值：

实际读取的元素个数.如果返回值与count不相同,则可能文件结尾或发生错误.

从ferror和feof获取错误信息或检测是否到达文件结尾.


int fseek(FILE *stream, long offset, int fromwhere);

功 能

重定位流(数据流/文件)上的文件内部位置指针

注意：不是定位文件指针，文件指针指向文件/流。位置指针指向文件内部的字节位置，随着文件的读取会移动，文件指针如果不重新赋值将不会改变指向别的文件。

描 述

函数设置文件指针stream的位置。如果执行成功，stream将指向以fromwhere（偏移起始位置：文件头0(SEEK_SET)，当前位置1(SEEK_CUR)，文件尾2(SEEK_END)）为基准，偏移offset（指针偏移量）个字节的位置。如果执行失败(比如offset超过文件自身大小)，则不改变stream指向的位置。

fseek函数和lseek函数类似，但lseek返回的是一个off_t数值，而fseek返回的是一个整型。

返回值

成功，返回0，失败返回-1，并设置errno的值，可以用perror()函数输出错误。

fseek position the file（文件） position（位置） pointer（指针） for the file referenced by stream to the byte location calculated by offset.


函数名:  long ftell(FILE *stream);

头文件: <stdio.h>

功 能

返回当前文件位置，也就是说返回FILE指针当前位置。

函数功能

：函数 ftell() 用于得到文件位置指针当前位置相对于文件首的偏移字节数。在随机方式存取文件时，由于文件位置频繁的前后移动，程序不容易确定文件的当前位置。使用fseek函数后再调用函数ftell()就能非常容易地确定文件的当前位置。

int ConfigIniFile::OpenFile( const char* szFileName )
{
    FILE    *fp;
    size_t    nLen;
    int        nRet;
    CloseFile();
    if ( 0 == szFileName )
    {
        return -1;
    }
#if defined(_WIN32)
    m_szFileName = _strdup( szFileName );
#else
    m_szFileName = strdup( szFileName );
#endif
    fp = fopen( m_szFileName, "rb" );
    if ( 0 == fp )
    {
        return -1;
    }
    nRet = fseek( fp, 0L, SEEK_END );
    if (nRet != 0)
    {
        fclose( fp );
        return -1;
    }
    nLen = (size_t) ftell( fp );
    m_szContent = (char* ) new char[ nLen + 1 ];
    m_szShadow  = (char* ) new char[ nLen + 1 ];
    if ( m_szShadow == 0  || m_szContent == 0 )
    {
        fclose( fp );
        return -1;
    }
    nRet = fseek( fp, 0L, SEEK_SET );
    if ( 0 != nRet )
    {
        fclose( fp );
        return -1;
    }
    m_nSize = fread( m_szContent, 1, nLen, fp );
    m_szContent[m_nSize] = '\0';
    memcpy( m_szShadow, m_szContent, m_nSize + 1 );
    ToLower( m_szShadow, m_nSize + 1 );
    fclose( fp );
    m_bOpen = true;
    return 0;
}