IniGroup Struct Reference

A group within an ini file. More...

#include <ini_type.h>

Public Member Functions
	IniGroup (std::string_view name, IniGroupType type)
	Construct a new in-memory group of an Ini file.
const IniItem *	GetItem (std::string_view name) const
	Get the item with the given name.
IniItem &	GetOrCreateItem (std::string_view name)
	Get the item with the given name, and if it doesn't exist create a new item.
IniItem &	CreateItem (std::string_view name)
	Create an item with the given name.
void	RemoveItem (std::string_view name)
	Remove the item with the given name.
void	Clear ()
	Clear all items in the group.

Data Fields
std::list< IniItem >	items
	all items in the group
IniGroupType	type
	type of group
std::string	name
	name of group
std::string	comment
	comment for group

Detailed Description

A group within an ini file.

Definition at line 34 of file ini_type.h.

Constructor & Destructor Documentation

IniGroup()

IniGroup::IniGroup	(	std::string_view	name,
		IniGroupType	type
	)

Construct a new in-memory group of an Ini file.

Parameters

parent	the file we belong to
name	the name of the group

Definition at line 42 of file ini_load.cpp.

References name, and StrMakeValid().

Member Function Documentation

Clear()

void IniGroup::Clear

(

)

Clear all items in the group.

Definition at line 98 of file ini_load.cpp.

References items.

Referenced by GraphicsSetSaveConfig(), IniSaveSettingList(), and PickerSaveConfig().

CreateItem()

IniItem & IniGroup::CreateItem

(

std::string_view

name

)

Create an item with the given name.

This does not reuse an existing item of the same name.

Parameters

name	name of the item to create.

Returns

the created item.

Definition at line 81 of file ini_load.cpp.

References items.

Referenced by GetOrCreateItem(), IniLoadFile::LoadFromDisk(), and PickerSaveConfig().

GetItem()

const IniItem * IniGroup::GetItem

(

std::string_view

name

)

const

Get the item with the given name.

Parameters

name	name of the item to find.

Returns

the requested item or nullptr if not found.

Definition at line 52 of file ini_load.cpp.

References items, and name.

Referenced by DumpSections(), BaseSet< T, Tnum_files, Tsearch_in_tars >::FillSetDetails(), FindItemValue(), GraphicsSetLoadConfig(), IniLoadSettings(), IsConversionNeeded(), HotkeyList::Load(), and LoadFromConfig().

GetOrCreateItem()

IniItem & IniGroup::GetOrCreateItem

(

std::string_view

name

)

Get the item with the given name, and if it doesn't exist create a new item.

Parameters

name	name of the item to find.

Returns

the requested item.

Definition at line 66 of file ini_load.cpp.

References CreateItem(), items, and name.

Referenced by GraphicsSetSaveConfig(), IniSaveSettingList(), HotkeyList::Save(), and SaveVersionInConfig().

RemoveItem()

void IniGroup::RemoveItem

(

std::string_view

name

)

Remove the item with the given name.

Parameters

name	Name of the item to remove.

Definition at line 90 of file ini_load.cpp.

References items, IniItem::name, and name.

Referenced by RemoveEntriesFromIni(), and SaveToConfig().

Field Documentation

comment

std::string IniGroup::comment

comment for group

Definition at line 38 of file ini_type.h.

Referenced by IniLoadFile::LoadFromDisk(), and SaveToConfig().

items

std::list<IniItem> IniGroup::items

all items in the group

Definition at line 35 of file ini_type.h.

Referenced by Clear(), CreateItem(), DumpGroup(), BaseSet< T, Tnum_files, Tsearch_in_tars >::FillSetDetails(), GetItem(), GetOrCreateItem(), GRFLoadConfig(), IniLoadSettingList(), PickerLoadConfig(), and RemoveItem().

name

std::string IniGroup::name

name of group

Definition at line 37 of file ini_type.h.

Referenced by GetGRFPresetList(), GetItem(), GetOrCreateItem(), IniGroup(), IniLoadFile::RemoveGroup(), and RemoveItem().

type

IniGroupType IniGroup::type

type of group

Definition at line 36 of file ini_type.h.

Referenced by DumpGroup(), and IniLoadFile::LoadFromDisk().

---

The documentation for this struct was generated from the following files:

• src/ini_type.h
• src/ini_load.cpp