Ini file that only supports loading. More...

#include <ini_type.h>

Inheritance diagram for IniLoadFile:

Public Types
using	IniGroupNameList = std::initializer_list<const std::string_view>

Public Member Functions
	IniLoadFile (const IniGroupNameList &list_group_names={}, const IniGroupNameList &seq_group_names={})
	Construct a new in-memory Ini file representation.
const IniGroup *	GetGroup (std::string_view name) const
	Get the group with the given name.
IniGroup *	GetGroup (std::string_view name)
	Get the group with the given name.
IniGroup &	GetOrCreateGroup (std::string_view name)
	Get the group with the given name, and if it doesn't exist create a new group.
IniGroup &	CreateGroup (std::string_view name)
	Create an group with the given name.
void	RemoveGroup (std::string_view name)
	Remove the group with the given name.
void	LoadFromDisk (std::string_view filename, Subdirectory subdir)
	Load the Ini file's data from the disk.
virtual std::optional< FileHandle >	OpenFile (std::string_view filename, Subdirectory subdir, size_t *size)=0
	Open the INI file.
virtual void	ReportFileError (std::string_view message)=0
	Report an error about the file contents.

Data Fields
std::list< IniGroup >	groups
	all groups in the ini
std::string	comment
	last comment in file
const IniGroupNameList	list_group_names
	list of group names that are lists
const IniGroupNameList	seq_group_names
	list of group names that are sequences.

Detailed Description

Ini file that only supports loading.

Definition at line 50 of file ini_type.h.

Member Typedef Documentation

◆ IniGroupNameList

using IniLoadFile::IniGroupNameList = std::initializer_list<const std::string_view>

Definition at line 51 of file ini_type.h.

Constructor & Destructor Documentation

◆ IniLoadFile()

IniLoadFile::IniLoadFile	(	const IniGroupNameList &	list_group_names = {},
		const IniGroupNameList &	seq_group_names = {} )

Construct a new in-memory Ini file representation.

Parameters

list_group_names A list with group names that should be loaded as lists instead of variables.

See also: IGT_LIST

Parameters

seq_group_names A list with group names that should be loaded as lists of names.

See also: IGT_SEQUENCE

Definition at line 106 of file ini_load.cpp.

References list_group_names, and seq_group_names.

Referenced by IniFile::IniFile().

Member Function Documentation

◆ CreateGroup()

IniGroup & IniLoadFile::CreateGroup ( std::string_view name )

Create an group with the given name.

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

Parameters

name	name of the group to create.

Returns: the created group.

Definition at line 160 of file ini_load.cpp.

References groups, IGT_LIST, IGT_SEQUENCE, IGT_VARIABLES, list_group_names, and seq_group_names.

Referenced by GetOrCreateGroup(), and LoadFromDisk().

◆ GetGroup() [1/2]

IniGroup * IniLoadFile::GetGroup ( std::string_view name )

Get the group with the given name.

Parameters

name	name of the group to find.

Returns: The requested group or nullptr if not found.

Definition at line 131 of file ini_load.cpp.

References groups.

◆ GetGroup() [2/2]

const IniGroup * IniLoadFile::GetGroup ( std::string_view name ) const

Get the group with the given name.

Parameters

name	name of the group to find.

Returns: The requested group or nullptr if not found.

Definition at line 117 of file ini_load.cpp.

References groups.

Referenced by BadgeClassLoadConfigFeature(), DumpGroup(), DumpSections(), BaseSet< T >::FillSetDetails(), GraphicsSetLoadConfig(), GRFLoadConfig(), IniLoadSettingList(), IniLoadSettings(), IsConversionNeeded(), HotkeyList::Load(), LoadFromConfig(), RemoveEntriesFromIni(), and SaveToConfig().

◆ GetOrCreateGroup()

IniGroup & IniLoadFile::GetOrCreateGroup ( std::string_view name )

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

Parameters

name	name of the group to find.

Returns: the requested group.

Definition at line 145 of file ini_load.cpp.

References CreateGroup(), and groups.

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

◆ LoadFromDisk()

void IniLoadFile::LoadFromDisk	(	std::string_view	filename,
		Subdirectory	subdir )

Load the Ini file's data from the disk.

Parameters

filename	the file to load.
subdir	the sub directory to load the file from.

Precondition: nothing has been loaded yet.

Definition at line 184 of file ini_load.cpp.

References StringConsumer::AnyBytesLeft(), IniGroup::comment, IniItem::comment, comment, CreateGroup(), IniGroup::CreateItem(), StringConsumer::GetLeftData(), StringConsumer::GetOrigData(), groups, IGT_SEQUENCE, StringConsumer::KEEP_SEPARATOR, OpenFile(), StringConsumer::PeekCharIfIn(), StringConsumer::ReadCharIf(), StringConsumer::ReadUntilChar(), StringConsumer::ReadUntilCharIn(), ReportFileError(), StringConsumer::SKIP_ONE_SEPARATOR, StringConsumer::SkipUntilCharNotIn(), StrMakeValid(), IniGroup::type, IniItem::value, and StringConsumer::WHITESPACE_OR_NEWLINE.

Referenced by BaseMedia< Tbase_set >::AddFile(), WindowDesc::LoadFromConfig(), ProcessIniFile(), and WindowDesc::SaveToConfig().

◆ OpenFile()

virtual std::optional< FileHandle > IniLoadFile::OpenFile	(	std::string_view	filename,
		Subdirectory	subdir,
		size_t *	size )

pure virtual

Open the INI file.

Parameters

	filename	Name of the INI file.
	subdir	The subdir to load the file from.
[out]	size	Size of the opened file.

Returns: File handle of the opened file, or std::nullopt.

Implemented in IniFile, and SettingsIniFile.

Referenced by LoadFromDisk().

◆ RemoveGroup()

void IniLoadFile::RemoveGroup ( std::string_view name )

Remove the group with the given name.

Parameters

name	name of the group to remove.

Definition at line 173 of file ini_load.cpp.

References groups, and IniGroup::name.

Referenced by DeleteGRFPresetFromConfig(), PickerSaveConfig(), and SaveToConfig().

◆ ReportFileError()

virtual void IniLoadFile::ReportFileError ( std::string_view message )

pure virtual

Report an error about the file contents.

Parameters

message The message to show.

Implemented in IniFile, and SettingsIniFile.

Referenced by LoadFromDisk().

Field Documentation

◆ comment

std::string IniLoadFile::comment

last comment in file

Definition at line 54 of file ini_type.h.

Referenced by LoadFromDisk(), and IniFile::SaveToDisk().

◆ groups

std::list<IniGroup> IniLoadFile::groups

all groups in the ini

Definition at line 53 of file ini_type.h.

Referenced by CreateGroup(), DumpSections(), GetGRFPresetList(), GetGroup(), GetGroup(), GetOrCreateGroup(), LoadFromDisk(), PickerLoadConfig(), RemoveGroup(), and IniFile::SaveToDisk().

◆ list_group_names

const IniGroupNameList IniLoadFile::list_group_names

list of group names that are lists

Definition at line 55 of file ini_type.h.

Referenced by CreateGroup(), IniFile::IniFile(), IniLoadFile(), and SettingsIniFile::SettingsIniFile().

◆ seq_group_names

const IniGroupNameList IniLoadFile::seq_group_names

list of group names that are sequences.

Definition at line 56 of file ini_type.h.

Referenced by CreateGroup(), and IniLoadFile().

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

src/ini_type.h
src/ini_load.cpp

Public Types

Public Member Functions

Data Fields

Detailed Description

Member Typedef Documentation

◆ IniGroupNameList

Constructor & Destructor Documentation

◆ IniLoadFile()

Member Function Documentation

◆ CreateGroup()

◆ GetGroup() [1/2]

◆ GetGroup() [2/2]

◆ GetOrCreateGroup()

◆ LoadFromDisk()

◆ OpenFile()

◆ RemoveGroup()

◆ ReportFileError()

Field Documentation

◆ comment

◆ groups

◆ list_group_names

◆ seq_group_names