总结:Qt读写ini配置文件(QSettings)

一、ini文件介绍

.ini 文件是Initialization File的缩写,即初始化文件。

INI文件被用来对操作系统或特定程序初始化或进行参数设置,以实现不同用户的要求。

一般不用直接编辑这些.ini文件,应用程序的图形界面即可操作以实现相同的功能。

在Qt中可以使用QSetting类来实现ini文件的读取和写入。

二、ini文件格式

ini文件主要有节(section)、键(key)、键值(value)部分组成。

节 (section) 用方括号括起来,单独占一行,例如:

[section]

键(key)又名属性(property),单独占一行用等号连接键名和键值,例如:

name=value

例子

[Section1 Name]   
KeyName1=value1   
KeyName2=value2   
...   
[Section2 Name]   
KeyName21=value21   
KeyName22=value22 

其中:[Section1 Name]用来表示一个段落。

因为INI文件可能是项目中共用的,所以使用[Section Name]段名来区分不同用途的参数区。

注意:使用分号表示(;)。在分号后面的文字,直到该行结尾都全部为注解。

三、QSettings

Qt通过QSettings类读写ini文件。

QSettings的存储设置,每个设置都由一个QString和一个QVariant组成,

QString指定设置的名称(键),QVariant存储与该键关联的数据。

头文件:QSetting.h
QSetting读写ini文件的步骤为:
    * 通过路径名称打开文件并设定为ini文件格式
    * 读/写数据
    * 关闭文件,删除句柄

QSettings::Format有两种:

QSettings::NativeFormat在windows平台可以读写windows注册表;

QSettings::IniFormat可以读写ini格式的配置文件。

3.1 写ini文件

// 根据ini文件路径新建QSettings类
QSettings  m_IniFile = new QSettings("ini文件的路径", QSettings::IniFormat);
 //通过setValue函数将键值对放在相对于的节下面
m_IniFile->setValue( "节名" + "/" + "键名",  "键对应的值");
delete m_IniFile;

分组写入
//根据ini文件路径新建QSettings类
QSettings  m_IniFile = new QSettings("ini文件的路径", QSettings::IniFormat);
m_IniFile ->beginGroup("节名");     // 设置当前节名,代表以下的操作都是在这个节中
m_IniFile->setValue( "键名",  "键对应的值"); // 因为上面设置了节了,这里不在需要把节名写上去
m_IniFile.endGroup();                   // 结束当前节的操作
delete m_IniFile;

//Qt中使用QSettings类读写ini文件
//QSettings构造函数的第一个参数是ini文件的路径,第二个参数表示针对ini文件,第三个参数可以缺省
QSettings *configIniWrite = new QSettings("config.ini", QSettings::IniFormat);
//向ini文件中写入内容,setValue函数的两个参数是键值对
//向ini文件的第一个节写入内容,ip节下的第一个参数
configIniWrite->setValue("/con/ip", "192.168.0.1");
//向ini文件的第一个节写入内容,ip节下的第二个参数
configIniWrite->setValue("/con/name", "aa");
//向ini文件的第二个节写入内容,port节下的第一个参数
configIniWrite->setValue("port/open", "2222");
configIniWrite->setValue("port/ports", "2222,111,33,444");
//写入完成后删除指针
delete configIniWrite;

生成文件 config.ini
[con]
ip=192.168.0.1
name=aa

[port]
open=2222
ports="2222,111,33,444"

3.2 读ini文件

//通过Value函数将节下相对应的键值读取出来
QString value = m_IniFile->Value( "节名" + "/" + "键名").toString;
//打开文件并指定为ini格式
QSettings* configIni = new QSettings(file_path, QSettings::IniFormat);
QString qTemp = "";
//读指定节点的指定数据,其中"Log"为节点,save_days为具体数据项
logDays = configIni->value("Log/save_days").toInt();
qTemp = configIni->value("Log/print_debug").toString();
printDbgLog = qTemp.compare("true", Qt::CaseInsensitive) == 0 ? true : false;
//删除指针,此处未关联父对象,必须手动删除,否则有内存泄露风险
delete configIni;

分组读取
settings.beginGroup("Setting");
QString strName = settings.value("Name").toString();
int nVersion = settings.value("Version").toInt();
settings.endGroup();
//Name:Qt Creator  Version:5

settings.beginGroup("User");
QString strUserName = settings.value("UserName").toString();
QString strPassword = settings.value("Password").toString();
settings.endGroup();
//UserName:WangL  Password:123456

[conn]
name=aaa
ip="192.168.1.10"
auto_con=1
speed=50
joints=0.000,-13.959,2.2,83.3,0.000,18.000,-30.000
tcp_offset= 133.4,0.0,0.0,0.0,0.0,-10.0

读配置文件
QSettings setting("config.ini",QSettings::IniFormat);
setting.setIniCodec("utf-8");// 解决乱码
QString name =setting.value("conn/name").toString();
int speed =setting.value("conn/speed").toInt();

qDebug() << name;
qDebug() << speed;

输出:
"aaa"
50

四、问题总结

4.1 QSettings写入数据丢失

在实际使用中,QSettings的写操作在某些情况下会丢失数据。

尤其在嵌入式Liunx环境中,通过断电方式关机,更容易丢失数据。

原因分析:

1,Qt的保存机制是先写到一个临时文件中,然后定时去同步到磁盘,所以不能实时生效。

2,setValue函数设置指定KEY的值,若该值已存在则替换先前的值,但不立即回写文件。

3,QSettings类的sync方法并不能立刻同步到磁盘上,需要使用系统sync或syncFlushFileBuffers进行同步。

解决措施:

1,在写完后调用QSettings的函数settings.sync();

2,调用Linux系统的shell命令system("sync");

#include <QtCore/QtCore>
#include <QSettings>
#include <QFile>
#include <QDebug>
#include <QTextCodec> 
 
void ConfigSetting(void)
{
    //文件路径+文件名
    QString fileName = QCoreApplication::applicationDirPath() + "/Config.ini";
    //创建配置目标,输入文件路径,文件格式
    QSettings *setting = new QSettings(fileName , QSettings::IniFormat);
    //设置文件编码,配置文件中使用中文时,这是必须的,否则乱码
    setting->setIniCodec(QTextCodec::codecForName("UTF-8"));
    // 判断文件是否存在
    if(QFile::exists(fileName)){// 文件存在,读出配置项
        // 这里的setting->value的第二参数,是配置项缺省值,即当读取的配置项不存在时,读取该值
        // User是配置组,name和age是配置项
        QString name = setting->value("User/name", "张三").toString();
        int age = setting->value("User/age", 30).toInt();
    }else {// 文件不存在,写入配置项,生成配置文件
        setting->setValue("User/name", "张三");
        setting->setValue("User/age", 30);
        // setValue只是把配置项写入了缓冲区,若要写入文件,还需执行同步
        // 不同步,无法写入文件,无法生成文件
        setting->sync();
        system("sync");//将内核缓冲写入文件(磁盘)
    }
    delete setting;
}

4.2 QSettings读取ini配置文件乱码

QSetting中的key值与项目标题如果用中文的话,打开会是乱码。

QSetting中变量值中如果包含分号,则值字符串需要用双引号(" ")来引用,

否则取值时候,只会取值到该变量第一个分号之前的内容。

4.3 QSettings 保存float 类型数据时乱码

使用QSettings 将 float 类型的数据写入到ini时

float dx = 1.0;

  sParamSetting->setValue("SectionData/d_correct",dx);

ini文件中内容如下:

d_correct=@Variant(\0\0\0\x87\xbeH\xb4\x39)

这是因为 QSettings在写float类型时有点问题,可以将float强制转化为double就可以了。

也可以将变量设置为double dx = 1.0;

sParamSetting->setValue("SectionData/d_correct", (double)(sCorrectParam.lcz_correct));

资料来源

https://www.cnblogs.com/qianxiaoPro/p/15623881.html

https://www.cnblogs.com/xiangtingshen/p/11145974.html

https://blog.csdn.net/yinyuchen1/article/details/75093895

https://www.cnblogs.com/mzy-google/p/5162107.html

https://blog.csdn.net/qq_33485434/article/details/80483883

https://blog.csdn.net/weixin_40583088/article/details/104660595

相关推荐
plmm烟酒僧23 分钟前
Windows下QT调用MinGW编译的OpenCV
开发语言·windows·qt·opencv
Black_Friend1 小时前
关于在VS中使用Qt不同版本报错的问题
开发语言·qt
CSUC1 小时前
【Qt】QTreeView 和 QStandardItemModel的关系
qt
冷凝女子2 小时前
【QT】海康视频及openCv抓拍正脸接口
qt·opencv·音视频·海康
苏三有春4 小时前
PyQt5实战——UTF-8编码器功能的实现(六)
开发语言·qt
Vanranrr4 小时前
C++ QT
java·c++·qt
兆。4 小时前
掌握 PyQt5:从零开始的桌面应用开发
开发语言·爬虫·python·qt
徒步僧15 小时前
ThingsBoard规则链节点:RPC Call Reply节点详解
qt·microsoft·rpc
可峰科技17 小时前
斗破QT编程入门系列之一:认识Qt:初步使用(四星斗师)
开发语言·qt
我喜欢就喜欢17 小时前
基于qt vs下的视频播放
开发语言·qt·音视频