INI文件的读取(C语言:GetPrivateProfileString/GetPrivateProfileInt)

INI文件格式说明

/*********************************************
  ini文件说明
  ini文件是文本文件，由节点(Section)和键值对(key=value)组成
  以';'开头的行为注释
  一般形式如下所示:
  +--------------- test.ini -----------------+
  |  [Section1]                              |
  |    key1=value1                           |
  |    key2=value2                           |
  |  ;这是注释                               |
  |  [Section2]                              |
  |    key3=value3                           |
  +------------------------------------------+
 *********************************************/

更详细的介绍可见http://blog.chinaunix.net/uid-25885064-id-3327199.html

 

GetPrivateProfileString 从INI文件中读取String值

辅助函数 dupFile 

//读取文件内容，保存到在heap区上申请的内存中
//成功返回内存地址，失败返回NULL
//参数fsize用于传出文件的内存区域的大小
char* dupFile(const char* FileName,long* fsize)
{
    char* buf = NULL;
    long size = 0;
    //读取文件，因为ini文件通常都很小，所以一次全部读取了
    FILE* fp = fopen(FileName,"r");
    do{
        if(fp == NULL){    //打开文件失败
            //puts("打开文件失败");
            break;
        }
        //获取文件大小
        if(fseek(fp,0,SEEK_END)){
            break;    //fseek失败
        }
        size = ftell(fp);    //获取当前偏移(文件长度)
        if(size<0){break;}

        //读取文件
        fseek(fp,0,SEEK_SET);
        buf = (char*)malloc(size+1);
        if(buf == NULL){break;}
        if(size == fread(buf,1,size,fp)){    //fread是阻塞模式，=
            buf[size] = '\0';
            //文件已经读取完成了
        }else{    //万一失败了呢？
            free(buf);
            buf = NULL;
            size = 0;
        }
    }while(0);
    fclose(fp);    //关闭文件
    if(fsize != NULL){*fsize = size;}
    return buf;
}

 

下面代码注释中写的不区分大小写是不对的，是区分大小写的。

/*函数说明:从FileName指定的ini文件中读取section节点下key键对应的value值(字符串)
 *参数说明:    Section:    节点名(不区分大小写)
 *            Key:        键名(不区分大小写)
 *            Default:    没有找到对应的value时的默认值
 *            ReturnedString:    接收找到的value的缓冲区
 *            nSize:        缓冲区的大小
 *            FileName:    ini文件路径
 *返回值:读取成功返回读取到的value的字符数。如果缓冲区不够大，value会被截断,返回nSize-1
 */

/*函数说明:从FileName指定的ini文件中读取section节点下key键对应的value值(字符串)
 *参数说明:    Section:    节点名(不区分大小写)
 *            Key:        键名(不区分大小写)
 *            Default:    没有找到对应的value时的默认值
 *            ReturnedString:    接收找到的value的缓冲区
 *            nSize:        缓冲区的大小
 *            FileName:    ini文件路径
 *返回值:读取成功返回读取到的value的字符数。如果缓冲区不够大，value会被截断,返回nSize-1
 */

unsigned long GetPrivateProfileString(
            const char*        Section,        //节点
            const char*        Key,            //键
            const char*        Default,        //默认值
            char*            ReturnedString,    //接收获取值的目标缓冲区
            unsigned long    nSize,            //目标缓冲区大小
            const char*        FileName        //ini文件路径
            )
{
    FILE*    fp;    //文件指针
    long    fsize;    //文件大小
    long    len;    //
    char*    buf;    //用于保存文件内容
    char*    psec;    //保存节点位置
    char*    pkey;    //指向文件中key位置
    char*    pval;    //指向文件中value的位置
    int        iscomment;    //用于判读是否是注释
    do{
        //获取文件内容
        buf = dupFile(FileName,&fsize);
        if(buf == NULL){break;}

        //查找节点位置
        char sbuf[1024];
        sprintf(sbuf,"[%s]",Section);
        psec = strstr(buf,sbuf);    //查找节点
        if(psec == NULL){
            printf("没有找到节点 %s \n",sbuf);
            break;//没有找到节点
        }
        //寻找key
        pkey = psec;    //查找的起点

        //查找key
        while((pkey = strstr(pkey,Key))!= NULL){
            //找到了匹配的，进入
            //判断找到的key是否与传入的一致(避免传入的是找到的前缀)
            //如传入 "abc" 找到的是 "abcdef\n"
            len = strlen(Key);
            pval =pkey + len;    //用pval指向pkey的尾部
            char t = pval[0];
            if(t == '=' || t==' ' || t=='\t'){
                break;    //找到了key,跳出本while
            }
            //没有找到key,去查找下一个匹配的
        }// end while
        if(pkey == NULL){
            printf("没有找到Key:%s\n",Key);
            break;    //没有找到key，跳出
        }
        //确定找到的key是当前节点的(查找key和当前节点之间还有无节点)
        pkey[-1] = '\0';    //从找到的key前截断
        psec = strchr(psec,']') +1;    //当前节点之后开始找
        while((psec=strchr(psec,'[')) != NULL){
            //判断该行是否是注释
            char* pt = psec++;    //psec指向'['的下一个去
            while(*(--pt) != ';'&& *pt != '\n');
            if(*pt == ';'){    continue;}//是注释，下一个
            //不是注释，判断是否是合法节点([]存在，有内容且在同一行)
            pt = psec;
            while(*(++pt) != ']' && *pt != '\n');
            if(*pt==']'){//当前行有']'来闭合，说明Section和Key之间还有节点
                pval = NULL;    //设置为NULL,表示不用找了
                break;
            }
        }//end while
        if(pval == NULL){
            break;    //找到的key不是传入Section下的
        }

        //确定了找到的key确实与传入的一致，查找value位置
        while(*pval != '=' && *pval != '\n' && *pval != '\0'){
            ++pval;    //查找'='的位置(key=value必须在一行)
        }
        if(*pval != '='){break;}    //没有找到value
        ++pval;    //现在pkey指向value(可能用空白，使用sscanf来去除)
        // 找到 value 的情况，仅此一处
        if((fsize - (pval - buf) - nSize) > 0){
            pval[nSize-1] = '\0';    //避免value太长
        }
        len = sscanf(pval,"%s",ReturnedString);    //sscanf %s 遇到空格\n\t\0都结束
        free(buf);    //释放buf
        return len;    //返回拷贝的长度

        //结束查找
    }while(0);

    //没有找到的情况
    strncpy(ReturnedString,Default,nSize-1);
    ReturnedString[nSize-1] = '\0';
    free(buf);    //释放buf
    return strlen(ReturnedString);
}

 

 

GetPrivateProfileInt从INI文件中读取Int值

/*函数说明:从FileName指定的ini文件中读取section节点下key键对应的value值(整型数)
 *参数说明:    Section:    节点名(不区分大小写)
 *            Key:        键名(不区分大小写)
 *            Default:    没有找到对应的value时的默认值
 *            FileName:    ini文件路径
 *返回值:读取成功返回找到的value值。没找到就返回Default
 */

int GetPrivateProfileInt( 
            const char*        Section,    // 指向包含 Section 名称的字符串地址 
            const char*        Key,        // 指向包含 Key 名称的字符串地址 
            int                Default,    // 如果 Key 值没有找到，则返回缺省的值是多少 
            const char*        FileName    // ini 文件的文件名 
)
{
    char buf[1024];
    sprintf(&buf[512],"%d",Default);    //获取默认值
    GetPrivateProfileString(Section,Key,&buf[512],buf,512,FileName);
    return atoi(buf);
}