配置文件格式 INI 快速上手

文章目录

  • 1.简介
  • 2.语法
    • 键值对
    • 注释
    • 大小写
    • 空白行
    • 数据类型
      • 字符串 (String)
      • 整数 (Integer)
      • 浮点数 (Float)
      • 布尔值 (Boolean)
      • 列表 (List)
  • 3.示例
  • 4.解析
  • 参考文献

1.简介

INI 的全称是 Initialization,即为初始化文件,最早是 Windows 系统配置文件所采用的格式。

有时候,INI 文件也会以不同的扩展名出现,如 .cfg、.conf、或 .txt。但为了可读性,不建议这么做。

因为 INI 并没有一个统一的官方标准,所以这里介绍常见的 INI 文件格式惯例。

2.语法

INI 是一种简单实用且应用广泛的配置文件格式,通常由节、键值对和注释组成。

节(Section)是键值对的分组。

一般情况下,节是可选的,不属于任何节的配置项属于全局配置项。

所有的 Section 名称都是独占一行,并且 Section 名字都被方括号 [] 包围。在 Section 声明后的所有键值对都属于该 Section。一个 Section 没有明显的结束标识符,一个 Section 的开始就是上一个 Section 的结束。

[section]

注意,不同节之间的变量可以同名。

正因为没有显式的“节结束符”(例如 XML 的</tag>)。因此,节在语法上不能任意嵌套。必要时,可以将层次结构扁平化,使用分隔符分隔多个节名(通常使用点 . 分隔)来实现嵌套。一级嵌套通常是支持的,称为子节。

[section]
domain = example.com[section.subsection]
foo = bar

键值对

每一个键值对表示一项配置,键与值使用等号分隔。

name=value

注释

注释以分号(;)开头,有一些 INI 管理器也支持使用井号(#)来注释。

; this is comment text

大小写

Windows 中的节和键名是不区分大小写的。大多数 Unix 风格的 INI 解析器也完全不区分大小写。

尽管部分 INI 解析器是支持大小写的,但为了良好的可读性,不建议这么做。

空白行

空白行通常被忽略,可以用来提高可读性。

数据类型

INI 文件格式的设计非常简单,不像 YAML、TOML 等更现代的配置文件格式那样明确支持多种数据类型。通常,INI 文件中的所有数据都是以字符串的形式存储的。然而,不同的解析器可能会尝试根据内容自动识别并转换数据类型。

字符串 (String)

默认情况下,所有值都被视为字符串。字符串值可以包含任何字符。

字符串值通常不需要引号,但在某些情况下可以使用引号(单引号或双引号)括起来。

key1=value1
key2=some text with spaces
key3="quoted string"

整数 (Integer)

一些解析器会尝试将纯数字的值解析为整数。

key1=42
key2=-3

浮点数 (Float)

类似地,包含小数点的数字可能会被解析为浮点数。

[Section]
key1=3.14
key2=-0.001

布尔值 (Boolean)

常见的布尔值表示法包括 true, false, yes, no, 1, 和 0。许多解析器会自动将这些值转换为布尔类型。

key1=true
key2=no
key3=1
key4=0

列表 (List)

虽然 INI 文件格式本身不直接支持列表,但可以通过使用分隔符(如逗号或分号)来模拟列表。某些解析器可以将这些值分割成列表。

key1=value1,value2,value3
key2=item1;item2;item3

3.示例

由于没有官方标准,建议在使用 INI 文件时遵循你所使用的解析器的具体规范,并保持文件结构的简单和一致。

以下是一个综合示例:

; Global section settings
globalKey1=value1[Section1]
# Section1 specific settings
key1=value1
key2=value2[Section2]
key1=value3  # Section2 specific settings
key3=value4

4.解析

下面是一个使用键值对表示的后台服务配置。

; server basic conf
[server]
name=UserProfileServer
maxconns=10000
queuecap=10000
queuetimeout=300# log conf
[log]
loglevel=ERROR
logsize=10M
lognum=10
logpath=/usr/local/app/log

在解析上面的配置时,可以按行读取,然后放到 map 中。

下面以 Go 为例,完成对上面配置文件的解析。

package mainimport ("bufio""errors""fmt""io""os""strings"
)func ParseConf(confPath string) (map[string]string, error) {if confPath == "" {return nil, errors.New("param is ill")}f, err := os.Open(confPath)if err != nil {return nil, err}defer f.Close()// store config infom := make(map[string]string)bfRd := bufio.NewReader(f)// read by line, the line terminator is '\n'for {line, err := bfRd.ReadString('\n')if err == io.EOF {return m, nil}if err != nil {return nil, err}// ignore blank lineif strings.TrimSpace(line) == "" {continue}// ignore comment lineif strings.TrimSpace(line)[0] == ';' || strings.TrimSpace(line)[0] == '#' {continue}// ignore section lineif strings.TrimSpace(line)[0] == '[' {continue}kv := strings.Split(strings.TrimSpace(line), "=")if len(kv) == 2 {m[kv[0]] = kv[1]}}
}func main() {conf, _ := ParseConf("server.ini")for k, v := range conf {fmt.Printf("%v=%v\n", k, v)}
}

运行结果:

name=UserProfileServer
maxconns=1000
queuecap=10000
queuetimeout=300
loglevel=ERROR
logsize=10M
lognum=10

推荐使用专业的第三方库来完成 INI 的解析,比如 Golang 中强大的 spf13/viper。

package mainimport ("fmt""github.com/spf13/viper"
)func main() {// 设置配置文件的名称和路径viper.SetConfigName("server.ini") // 可以不写文件扩展名viper.AddConfigPath("..")         // 在当前目录查找配置文件// 设置配置文件类型为 INIviper.SetConfigType("ini")// 读取配置文件if err := viper.ReadInConfig(); err != nil {fmt.Printf("Error reading config file, %s", err)return}// 获取配置项的值fmt.Println("server.name:", viper.GetString("server.name"))fmt.Println("server.maxconns:", viper.GetInt("server.maxconns"))fmt.Println("server.queuecap:", viper.GetInt("server.queuecap"))fmt.Println("server.queuetimeout:", viper.GetInt("server.queuetimeout"))fmt.Println("log.loglevel:", viper.GetString("log.loglevel"))fmt.Println("log.logsize:", viper.GetString("log.logsize"))fmt.Println("log.lognum:", viper.GetInt("log.lognum"))fmt.Println("log.logpath:", viper.GetString("log.logpath"))
}

运行结果:

server.name: UserProfileServer
server.maxconns: 10000
server.queuecap: 10000
server.queuetimeout: 300
log.loglevel: ERROR
log.logsize: 10M
log.lognum: 10
log.logpath: /usr/local/app/log

参考文献

INI file - wikipedia
Apache Documentation for org.apache.commons.configuration2.INIConfiguration

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.mzph.cn/bicheng/48657.shtml

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

基于SpringBoot+Vue的校园志愿者管理系统(带1w+文档)

基于SpringBootVue的校园志愿者管理系统(带1w文档) 基于SpringBootVue的校园志愿者管理系统(带1w文档) 本次设计任务是要设计一个校园志愿者管理系统&#xff0c;通过这个系统能够满足管理员和志愿者的校园志愿者信息管理功能。系统的主要功能包括首页、个人中心、志愿者管理、…

pytorch学习(十六)conda和pytorch的安装

1.安装anaconda 1.1 首先下载安装包 1&#xff09;进入anaconda官网 Anaconda | The Operating System for AI 2&#xff09;注册一下 3&#xff09;下载 4&#xff09;一直点直到安装完 5&#xff09;配置环境变量 在path路径中加入 Anaconda安装路径 Anaconda安装路径\S…

量化交易对短期收益的提升效果

量化交易对短期收益的提升效果在当前金融市场中备受关注。随着科技的进步和市场环境的变化&#xff0c;量化交易利用先进的算法和模型&#xff0c;通过对大量数据的分析和处理&#xff0c;显著提升了短期投资的回报率。这种交易方式在全球经济不确定性增加的背景下&#xff0c;…

LeetCode 123题: 买卖股票的最佳时机 III代码优化(原创)

之前完成了LeetCode 123题&#xff1a; 买卖股票的最佳时机 III&#xff08;原创&#xff09;-CSDN博客&#xff0c;虽然完成代码编写&#xff0c;并提交成功&#xff0c;但运行效率不是很高。执行时长高达62ms&#xff0c;见下图&#xff1a; 看了下代码感觉可以通过将三维数组…

提交(git-add git-commit git-push)

当修改好一个功能的时候&#xff0c;可以提交到远程仓库&#xff0c;这样就等于更新了一次版本&#xff0c;那么下次改修了文件的话&#xff0c;是跟这个版本做对比的 git status&#xff0c; 查看文件修改情况&#xff0c;git add 假如你只想提交1个文件&#xff0c;那么直接…

IOC、DI<5> Unity、AOP、延迟获取对象、检索容器中注册信息

Unity.InterceptionExtension.ICallHandler实现一个操作日志记录功能 其它跟上一次一样 <?xml version"1.0" encoding"utf-8" ?> <configuration><configSections><section name"unity" type"Microsoft.Practice…

新手入门python该如何开始学习?学习路线是什么呢?

今天这篇文章从三个点给大家介绍一下新手学习Python的正确路线是什么、python最核心的知识点是什么 Python学习路线 Python学习路线可以大致分为以下几个阶段&#xff0c;每个阶段都包含了一系列核心知识点和技能&#xff1a; 第一阶段&#xff1a;Python基础 Python语言基础…

扫描某个网段下存活的IP:fping

前言&#xff1a; 之前用arp统计过某网段下的ip&#xff0c;但是有可能统计不全。网络管理平台又不允许登录。想要知道当前的ip占用情况&#xff0c;可以使用fping fping命令类似于ping&#xff0c;但比ping更强大。与ping需要等待某一主机连接超时或发回反馈信息不同&#x…

递归与迭代

1. 概念区别 递归&#xff08;recursion&#xff09;&#xff1a;递归常被用来描述以自相似方法重复事物的过程&#xff0c;在数学和计算机科学中&#xff0c;指的是在函数定义中使用函数自身的方法。&#xff08;A调用A&#xff09; 迭代&#xff08;iteration&#xff09;&…

nodejs学习之Rollup

官网 https://github.com/rollup/rollup 英文文档 中文文档 是什么 Rollup 是一个用于 JavaScript 的模块打包工具&#xff0c;它将小的代码片段编译成更大、更复杂的代码&#xff0c;例如库或应用程序。它使用 JavaScript 的 ES6 版本中包含的新标准化代码模块格式&#xf…

数据挖掘与分析部分实验内容

一、机器学习算法的应用 1. 朴素贝叶斯分类器 相关代码 import pandas as pd from sklearn.model_selection import train_test_split from sklearn.naive_bayes import GaussianNB, MultinomialNB from sklearn.metrics import accuracy_score # 将数据加载到DataFrame中&a…

基于声学基元的高质量空间音频生成框架

关键词&#xff1a;人体姿态、声学基元、空间音频建模、体积渲染 过去几年中&#xff0c;渲染和动画制作逼真的3D人体模型技术已经发展成熟&#xff0c;并且达到了令人印象深刻的质量水平。然而&#xff0c;与这些全身模型相关联的空间音频建模&#xff0c;却在很大程度上被忽视…

【C++报错已解决】“Null Pointer Dereference“

&#x1f3ac; 鸽芷咕&#xff1a;个人主页 &#x1f525; 个人专栏: 《C干货基地》《粉丝福利》 ⛺️生活的理想&#xff0c;就是为了理想的生活! 引言 在软件开发过程中&#xff0c;遇到 “Null Pointer Dereference” 报错可能会让你感到困惑。这个错误提示通常意味着你的程…

Git分支合并以及分支部分合并 提交记录合并

Git分支合并,以及分支部分合并,提交记录合并 最近工作中用到git分支合并的场景,记录一下. 分支整体合并,合并所有记录 仅合并分支部分代码

信竞2024年csp-j模拟赛第二场赛后总结

T1&#xff1a;Mixing Milk 题目分析&#xff1a; 这是一道模拟题&#xff0c;通过for循环模拟倒牛奶的过程 正确代码&#xff1a; #include<bits/stdc.h> using namespace std; int c[4],m[4]; int main() {for(int x1; x<3; x)cin>>c[x]>>m[x];for(…

css3 中的伪类和伪元素

什么是伪类&#xff0c;什么是伪元素 伪类是用来添加特殊状态的选择器,它们以冒号(:)开头。伪类可以添加到任何现有的选择器上,用来选择处于特定状态的元素。 伪元素是用来选择元素的特定部分的选择器,它们以双冒号(::)开头。伪元素可以创建出在文档树中不存在的元素。 css3 …

《从C/C++到Java入门指南》- 16.多维数组

多维数组 二维数组 打印一下 Java 中的二维数组会发现&#xff0c;打印的是 JVM 中的地址&#xff1a; import java.util.*; public class Main {public static void main(String[] args) {int arr[][] {{1, 2, 3},{4, 5, 6}};int ns[] {3, 4, 1, 3};System.out.println(A…

鸿蒙仓颉语言【互操作InterOp】

interoperate 语言的互操作&#xff0c;是必不可少的核心能力&#xff0c;在不同的操作系统平台上要与不同基础的OS接口api进行交互&#xff0c;以创建更合适的兼容层。 仓颉使用foreign关键字来声明调用的不同操作系统的基础API&#xff0c;声明的同时&#xff0c;明确数据类…

leetcode hot100 (面试复习用)

数组 最大子数组和 给你一个整数数组 nums &#xff0c;请你找出一个具有最大和的连续子数组&#xff08;子数组最少包含一个元素&#xff09;&#xff0c;返回其最大和。 示例&#xff1a; 输入&#xff1a;nums [-2,1,-3,4,-1,2,1,-5,4]输出&#xff1a;6解释&#xff1…

【Qt】按钮的属性相关API

目录 一. QPushButton 二. QRadioButton 按钮组 三. QCheckBox Qt中按钮的继承体系如下图 QAbstractButton是一个抽象类&#xff0c;集成了按钮的核心属性和API 按钮说明QPushButton&#xff08;普通按钮&#xff09;最常见的按钮&#xff0c;用于触发操作或者事件。可以设…