ini文件概要
ini文件是一种系统配置文件,它有特定的格式组成。通常做法,我们读取ini文件并按照ini格式进行解析即可。在c++语言中,提供了模板类的功能,所以我们可以提供一个更通用的模板类来解析ini文件。
1、为什么要使用ini或者其它(例如xml,json)配置文件?
如果我们程序没有任何配置文件时,这样的程序对外是全封闭的,一旦程序需要修改一些参数必须要修改程序代码本身并重新编译,这样很不好,所以要用配置文件,让程序发布后还能根据需要进行必要的配置;配置文件有很多如INI配置文件,XML配置文件,还有就是可以使用系统注册表等。注意:ini的后缀名也不一定是".ini"也可以是".cfg",“.conf ”或者是”.txt"。因为ini文件实质就是txt文本文件。配置文件除了读取外还可以写入:例如用户设置了习惯模式,这样下次启动读取文件的时候也是该模式
kv文件,是ini执行后出现的文件
2、ini配置文件的格式
- 注释:以分号(;)开头,在我这个IniConfigParser实现中会视为注释行
- Section:这是划分不同用途的配置选项分类管理的逻辑划分单元,一个Section下包含多个Option
- Option:每个Section下就包含多个Option,一个Option就对应一个Key-Value-Pair.
- Document:是表示整个ini配置文档的,他直接管理对象单元是不同名称的Section.
补充:
ini文件有特定格式,由节、键、值组成。
节表示一段数据开头,用[]包含。之后的内容为“键=值”组成。注释使用分号表示(;)。在分号后面的文字,直到该行结尾都全部为注解。
如下为一个ini文件的例子:
1)对节进行说明:
所有的parameters都是以sections为单位结合在一起的。所有的section名称都是独占一行,并且sections名字都被方括号包围着([ and ])。在section声明后的所有parameters都是属于该section。对于一个section没有明显的结束标志符,一个section的开始就是上一个section的结束,或者是end of the file。Sections一般情况下不能被nested,当然特殊情况下也可以实现sections的嵌套。因为INI文件可能是项目中共用的,所以使用[Section Name]段名来区分不同用途的参数区。
2)对参数进行说明:INI所包含的最基本的“元素”就是parameter;每一个parameter都有一个name(key)和一个value,name和value是由等号“=”隔开。name在等号的左边。
3)对注释内容进行说明:在INI文件中注释语句是以分号 “;” 开始的(有些人定义类是由#注释,例如下面的RrConfig)。所有的所有的注释语句不管多长都是独占一行直到结束的,在分号和行结束符之间的所有内容都是被忽略的。
2、ini配置文件实现方式
解析文件后按照状态流转进行读取, 如下:
全部读取文件内容到内存后, 按照状态流转一次循环全部字符完成解析,解析内容存放成2级map结构。
代码实例分析
解析ini配置文件源码
CParseIniFile.h #pragma once #include <fstream> #include <iostream> #include <string> #include <map> using namespace std; #define COMMENT_CHAR '#' class CParseIniFile { public: CParseIniFile(); ~CParseIniFile(); bool ReadConfig(const string& filename, map<string, string>& mContent, const char* section); bool AnalyseLine(const string & line, string & key, string & val); void Trim(string & str); bool IsSpace(char c); bool IsCommentChar(char c); void PrintConfig(const map<string, string> & mContent); private: };
CParseIniFile.cpp #include "CParseIniFile.h" CParseIniFile::CParseIniFile() { } CParseIniFile::~CParseIniFile() { } bool CParseIniFile::ReadConfig(const string& filename, map<string, string>& mContent, const char* section) { mContent.clear(); ifstream infile(filename.c_str()); if (!infile) { //LOG4CXX_ERROR(logger, "file open error!"); return false; } string line, key, value; int pos = 0; string Tsection = string("[") + section + "]"; // string Tsection = "[" + section + "]";//错误写法invalid operands of types ‘const char [2]’ and ‘const char*’ to binary ‘operator+’ cout<< "Tsection: " << Tsection << endl; //输出:Tsection: [Student1] bool flag = false; while (getline(infile, line)) { if (!flag) { pos = line.find(Tsection, 0); // 查找节 Tsection 第一次出现的位置 string中的 find 返回的是int类型,找到就返回所在位置,未找到返回-1 ;0 代表从0位置开始查找 if (-1 == pos) { continue; //继续找 } else //找到第一个出现的[节] { flag = true; getline(infile, line);//将流对象infile 中的数据逐行存取到line中 cout<< "line: "<< line << " length: "<< line.length() << endl; //输出:line: name = liubei length: 13 此处length包含空格和“=” } } //length()函数是string的内置成员方,用于返回string类型字符串的实际长度。 if (0 < line.length() && '[' == line.at(0)) //line.at(0) 表示获取字符串line的第0号位字符 { cout<< "line.length():" << line.length() << " line.at(0): " << line.at(0) << endl; //输出:line.length():10 line.at(0): [ break; } if (0 < line.length() && AnalyseLine(line, key, value)) { if (value.length() > 0) { if (value[value.size() - 1] == '\r') { value[value.size() - 1] = '\0'; //查看string赋值操作,可以直接把字符赋值给当前的字符串,此处表示对最后一位字符赋值0 } } mContent[key] = value; } } infile.close(); return true; } bool CParseIniFile::AnalyseLine(const string & line, string & key, string & val) { if (line.empty()) { return false; } int start_pos = 0, end_pos = line.size() - 1, pos = 0; if ((pos = line.find(COMMENT_CHAR)) != -1) { if (0 == pos) {//行的第一个字符就是注释字符 return false; } end_pos = pos - 1; } string new_line = line.substr(start_pos, start_pos + 1 - end_pos); // 预处理,删除注释部分 if ((pos = new_line.find('=')) == -1) { return false; // 没有=号 } key = new_line.substr(0, pos); val = new_line.substr(pos + 1, end_pos + 1 - (pos + 1)); Trim(key); if (key.empty()) { return false; } Trim(val); return true; } void CParseIniFile::Trim(string & str) { if (str.empty()) { return; } int i, start_pos, end_pos; for (i = 0; i < str.size(); ++i) { if (!IsSpace(str[i])) { break; } } if (i == str.size()) { //全部是空白字符串 str = ""; return; } start_pos = i; for (i = str.size() - 1; i >= 0; --i) { if (!IsSpace(str[i])) { break; } } end_pos = i; str = str.substr(start_pos, end_pos - start_pos + 1); } bool CParseIniFile::IsSpace(char c) { if (' ' == c || '\t' == c) { return true; } return false; } bool CParseIniFile::IsCommentChar(char c) { switch (c) { case COMMENT_CHAR: return true; default: return false; } } void CParseIniFile::PrintConfig(const map<string, string> & mContent) { map<string, string>::const_iterator mite = mContent.begin(); for (; mite != mContent.end(); ++mite) { cout << mite->first << "=" << mite->second << endl; } }
config.ini文件
[Student1] name = liubei age = 28 record = 8 [Student2] ;name = zhangfei //注释 age = 29 record = 4 [Student3] name = guanyu age = 26 record = 6
主函数
#include "CParseIniFile.h" #include <iostream> #include <stdio.h> #define _KEY_ "name" //用宏定义name为_KEY_ int main() { // string fileName; // string section = "Student1"; map<string, string> fname; CParseIniFile config; bool flage = config.ReadConfig("config.ini", fname, "Student1"); //参数一:配置文件名(或路经名);参数二:map容器 参数三:需要写入map容器中的节 if (flage) { //判断节内的内容是否成功读取到map容器 auto name = fname["name"]; auto age = fname["age"]; // age是key,此处用到map容器的一种赋值方式map[key] = value // 此处key是字符串,必须加“”,要不然找不到变量定义 auto record = stod(fname["record"]); // stod 将字符串转化成double型 cout << name << endl; cout << age << endl; cout << record << endl; } bool flage2 = config.ReadConfig("config.ini", fname, "Student2"); if (flage2) { //name的另一种获取方法 auto Iter = fname.find(_KEY_); //利用map容器的find()查找节Student2下的name //判断该节中是否有name,或者查到name,但其对应的value为空,我们会给其赋一个默认值 string name; if ((fname.cend() == Iter) || (!(Iter->second.size()))) { name = "zhaoyun"; } else { name = Iter->second; } auto age = atof(fname["age"].c_str()); auto record = stod(fname["record"]); cout << name << endl; cout << age << endl; cout << record << endl; } // config.PrintConfig(fname); }
注意:
1 map容器的查找和key和value的赋值请参考:
https://blog.csdn.net/zxy_ZXY123/article/details/135966846
2 c_str()及atof()和stod()的用法参考:
c++中c_str()及atof()和stod()的用法详细解析-CSDN博客
3 string 字符串长度的获取以及find()查找及子串获取 substr()参考:
基于知识补充:
‘\n’ 换行,光标移到下一行的开头;
'\r' 回车,光标移到当前行的开头,不会换到下一行,如果接着输出的话,本行以前的内容会被逐一覆盖;
\t:表示水平制表空行操作,相当于Tab键,不会换行
{ cout << "this is the first line\n"; cout << "this is the second line\r"; cout << "this is the third line\n"; //会覆盖第二行length长度的部分 cout << "this is the fouth line\r"; cout << "this is the fifth line\n"; cout<<"First"<<"\n"<<"Second"<<endl; cout<<"First123"<<"\r"<<"Second"<<endl; //不换行,光标回到本行首位开始等长度覆盖 cout<<"First123"<<"\t"<<"Second"<<endl; cout<<"First123"<<"\0"<<"Second"<<endl; } 输出: this is the first line this is the third linee this is the fifth line First Second Second23 First123 Second First123Second
关于C++字符串中的"\0"问题
C++中没有字符串对象,字符串可以看成是字符数组,不过它们之间又有区别。
简单的来说就是区别在最后的一个元素"\0"上,它标志着一串字符是否是字符串。用字符串初始化字符数组时,"\0"附带在后面与前面的字符一起作为字符数组的元素。
在内存中,就是根据"\0"来确认字符串,如果找不到就会沿着字符一直找下去。它占用内存空间,但是不计入串长。
用字符串初始化字符数组时,系统会在字符数组的末尾自动加上一个字符"\0",因此数组的大小比字符串中实际字符的个数大。如:sizeof(str1)=strlen(str1) +1;
如果是用字符初始化数组,则一定要把"\0"作为一个元素放在初始值表中,不然就不会成为一个字符串。
① ‘0’ 代表 字符0 ,对应ASCII码值为 0x30 (也就是十进制 48) ② '\0' 代表 空字符(转义字符)【输出为空】, 对应ASCII码值为 0x00(也就是十进制 0), 用作字符串结束符 ③ 0 代表 数字0, 若把 数字0 赋值给 某个字符,对应ASCII码值为 0x00(也就是十进制0) ④ “0” 代表 一个字符串, 字符串中含有 2个字符,分别是 '0' 和 '\0' 下面补充说明(帮助理解) ① char ch_0 = ‘0’; // 字符0 赋值给一个字符,实际赋的 码值 为 0x30,十进制48 std::cout << ch_0 << '\n'; // 输出的 是 码值0x30 对应的 字符 0, 界面上看到的是0 std::cout << int(ch_0) << '\n'; // 输出的 是字符 ‘0’ 对应的码值 0x30,即十进制48 ,界面上看到的是 48 ② char ch_0 = '\0'; // 字符‘\0' 赋值给一个字符,实际赋的 码值 为 0x00,十进制0 std::cout << ch_0 << '\n'; // 输出的 是 码值0x00 对应的 空字符【NULL】, 界面上看到的是 空白,什么也看不见 std::cout << int(ch_0) << '\n'; // 输出的 是字符 ‘\0’ 对应的码值 0x00,即十进制0 ,界面上看到的是 0 ③ char ch_0 = 0; // 数字0 赋值给一个字符,实际赋的是 码值 std::cout << ch_0 << '\n'; // 输出的 是 码值0 对应的 字符,此处为 空白字符,即输出为空,界面上什么也看不见 std::cout << int(ch_0) << '\n'; // 输出的 是码值 0x00,即十进制0 ,界面上看到的是0 ④ char ch_0[ ] = "0"; // 字符串 “0” 初始化字符数组 std::cout << sizeof(ch_0) << ‘\n’; // 输出 ch_0 字节数, 界面显示 为2 std::cout << ch_0[0] << '\n'; // 输出字符 ‘0’,界面上看到的是 0 std::cout << ch_0[1] << '\n'; // 输出字符 ‘\0’,界面上看到的是 空白 std::cout << int( ch_0[0] )<< '\n'; // 输出字符 ‘0’ 对应的码值 0x30,界面上看到的是 48 std::cout << int ( ch_0[1] )<< '\n'; // 输出字符 ‘\0’ 对应的码值 0x00,界面上看到的是 0 注:以上代码 若是想拷贝试试,可能需要做相应的调整。因为为了方便大家学习,我有些地方多加了空格,能看得更清楚些,有问题欢迎留言探讨。 总结:记住几点 ① 用 数值 给 某个 字符变量 赋值时,相当赋 与该数字相同码值 所对应的字符 ② 用 字符 给 某个 字符变量赋值时, 即 赋 字符本身 ③ ‘\0’ 对应的 码值为0, 界面显示为 空白
\0是C++中字符串的结尾标志,存储在字符串的结尾。比如char cha[5]表示可以放4个字符的字符串,由于c/c++中规定字符串的结尾标志为'\0',它虽然不计入串长,但要占内存空间,而一个汉字一般用两个字节表示,且c/c++中如一个数组cha[5],有5个变量,分别是 cha[0] , cha[1] , cha[2] , cha[3] , cha[4] , 所以cha[5]可以放4个字母(数组的长度必须比字符串的元素个数多1,用以存放字符串结束标志'\0')或者放2个汉字(1个汉字占2个字节,1个字母占一个字节),cha[5]占5个字节的内存空间。
'\0'的ASCII是0 例如: char sText[5]; sText[0]='a'; sText[1]='a'; sText[2]='a'; sText[3]='a'; sText[4]='\0'; cout<<sText<<endl; //这样输出就是4个a // 如果数组的第五个元素即: sText[4]='a'; cout<<sText<<endl; //这样输出就是5个a和一堆乱码,甚至发生系统错误,因为该字符串没有字符串结尾符
{ // string s("liubei"); //string s("zhangfeel\r"); string s("zhangfeel"); cout << "s.size(): " << s.size() << endl; // \r占一个字符长度 cout << "sizeof(s): " << sizeof(s) << endl; cout << "s.size() - 1: " << s.size() - 1 << endl;//实际上取的最后一位l cout<< "s1 = " << s << endl; cout << "s[s.size() - 1]1: " << s[s.size() - 1] << endl; s[s.size() - 1] = '\0';//对字符串最后一位置空 cout<< "s2 = " << s << endl; cout << "s[s.size() - 1]2: " << s[s.size() - 1] << endl; if (s[s.size() - 1] == '\r') { s[s.size() - 1] = '\0'; cout << "s[s.size() - 1]_if: " << s[s.size() - 1] << endl; } 输出: s.size(): 9 sizeof(s): 32 s.size() - 1: 8 s1 = zhangfeel s[s.size() - 1]1: l s2 = zhangfee s[s.size() - 1]2:
string类对象以'\0'作为结束标志吗?
从图中我们可以看见,'\0'被插入到了字符串中并计入到了size中,但是string类型在直接输出时,并没有以'\0'作为输出的结束标志;而转为C类型字符串输出时,把'\0'当作了结束标志。
因此可以得出结论,string类型对象并不会以'\0'作为结束标志。
注意:
①C++中的string类对象会在末尾补上'\0',这是因为C++有C语言的历史包袱。因为C语言的字符串以'\0'结尾,所以为了方便在必要时将string字符串转为C类型字符串,所以string类型对象会在末尾补上一个不计入size和capacity的'\0'。②C++中的string类对象并不会将'\0'作为结束标志,因为string类对象内部维护了一个记录自身长度的成员变量size,在输出string类对象时会根据size的大小决定输出多少个字符,而不是看'\0'的位置决定输出到哪个字符结束。
注:用双引号括起来的字符串也属于C类型的字符串,所以它也是会以'\0'结尾的。
参考:【C++】string类构建的字符串以‘\0‘结束吗?_string输出是遇到\0停止还是不读取\0-CSDN博客
小结
声明:本文为学习总结,转载请注明出处!
参考:
2 https://jingyan.baidu.com/article/67508eb4c2fcf1ddcb1ce439.html