d09b504bc5
# Conflicts: # .github/workflows/ci-build.yml # .github/workflows/release-linux.yml # .github/workflows/release-macos.yml # .github/workflows/release-source.yml # .github/workflows/release.yml # CMakeLists.txt # COMPILING.md # src/ai/ai_core.cpp # src/ai/ai_gui.cpp # src/bridge_gui.cpp # src/company_gui.cpp # src/console_cmds.cpp # src/core/CMakeLists.txt # src/core/smallmap_type.hpp # src/disaster_vehicle.h # src/effectvehicle_base.h # src/fontcache.cpp # src/game/game_core.cpp # src/game/game_gui.cpp # src/gamelog.cpp # src/gamelog_internal.h # src/group_gui.cpp # src/linkgraph/linkgraph.h # src/misc.cpp # src/network/core/config.h # src/network/core/udp.cpp # src/network/network_chat_gui.cpp # src/network/network_content_gui.cpp # src/network/network_gui.cpp # src/newgrf.cpp # src/newgrf_gui.cpp # src/newgrf_profiling.cpp # src/newgrf_profiling.h # src/object_gui.cpp # src/openttd.cpp # src/openttd.h # src/order_gui.cpp # src/os/windows/font_win32.cpp # src/rail_gui.cpp # src/road.cpp # src/road_gui.cpp # src/saveload/afterload.cpp # src/saveload/saveload.h # src/script/api/script_controller.cpp # src/script/api/script_roadtypelist.cpp # src/script/script_config.cpp # src/script/script_config.hpp # src/script/script_instance.cpp # src/script/script_scanner.cpp # src/script/squirrel.cpp # src/script/squirrel_helper.hpp # src/settings_gui.cpp # src/settings_internal.h # src/settings_type.h # src/table/settings/network_private_settings.ini # src/timetable_gui.cpp # src/vehicle.cpp # src/vehicle_base.h # src/window_gui.h
99 lines
3.9 KiB
C++
99 lines
3.9 KiB
C++
/*
|
|
* This file is part of OpenTTD.
|
|
* OpenTTD is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, version 2.
|
|
* OpenTTD is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
|
|
* See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with OpenTTD. If not, see <http://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
/** @file ini_type.h Types related to reading/writing '*.ini' files. */
|
|
|
|
#ifndef INI_TYPE_H
|
|
#define INI_TYPE_H
|
|
|
|
#include "fileio_type.h"
|
|
#include <string>
|
|
#include <optional>
|
|
|
|
/** Types of groups */
|
|
enum IniGroupType {
|
|
IGT_VARIABLES = 0, ///< Values of the form "landscape = hilly".
|
|
IGT_LIST = 1, ///< A list of values, separated by \n and terminated by the next group block.
|
|
IGT_SEQUENCE = 2, ///< A list of uninterpreted lines, terminated by the next group block.
|
|
};
|
|
|
|
/** A single "line" in an ini file. */
|
|
struct IniItem {
|
|
IniItem *next; ///< The next item in this group
|
|
std::string name; ///< The name of this item
|
|
std::optional<std::string> value; ///< The value of this item
|
|
std::string comment; ///< The comment associated with this item
|
|
|
|
IniItem(struct IniGroup *parent, const std::string &name);
|
|
~IniItem();
|
|
|
|
void SetValue(const std::string_view value);
|
|
};
|
|
|
|
/** A group within an ini file. */
|
|
struct IniGroup {
|
|
IniGroup *next; ///< the next group within this file
|
|
IniGroupType type; ///< type of group
|
|
IniItem *item; ///< the first item in the group
|
|
IniItem **last_item; ///< the last item in the group
|
|
std::string name; ///< name of group
|
|
std::string comment; ///< comment for group
|
|
|
|
IniGroup(struct IniLoadFile *parent, const std::string &name);
|
|
~IniGroup();
|
|
|
|
IniItem *GetItem(const std::string &name, bool create);
|
|
void RemoveItem(const std::string &name);
|
|
void Clear();
|
|
};
|
|
|
|
/** Ini file that only supports loading. */
|
|
struct IniLoadFile {
|
|
IniGroup *group; ///< the first group in the ini
|
|
IniGroup **last_group; ///< the last group in the ini
|
|
std::string comment; ///< last comment in file
|
|
const char * const *list_group_names; ///< nullptr terminated list with group names that are lists
|
|
const char * const *seq_group_names; ///< nullptr terminated list with group names that are sequences.
|
|
|
|
IniLoadFile(const char * const *list_group_names = nullptr, const char * const *seq_group_names = nullptr);
|
|
virtual ~IniLoadFile();
|
|
|
|
IniGroup *GetGroup(const std::string &name, bool create_new = true);
|
|
void RemoveGroup(const char *name);
|
|
|
|
void LoadFromDisk(const std::string &filename, Subdirectory subdir, std::string *save = nullptr);
|
|
|
|
/**
|
|
* Open the INI file.
|
|
* @param filename Name of the INI file.
|
|
* @param subdir The subdir to load the file from.
|
|
* @param[out] size Size of the opened file.
|
|
* @return File handle of the opened file, or \c nullptr.
|
|
*/
|
|
virtual FILE *OpenFile(const std::string &filename, Subdirectory subdir, size_t *size) = 0;
|
|
|
|
/**
|
|
* Report an error about the file contents.
|
|
* @param pre Prefix text of the \a buffer part.
|
|
* @param buffer Part of the file with the error.
|
|
* @param post Suffix text of the \a buffer part.
|
|
*/
|
|
virtual void ReportFileError(const char * const pre, const char * const buffer, const char * const post) = 0;
|
|
};
|
|
|
|
/** Ini file that supports both loading and saving. */
|
|
struct IniFile : IniLoadFile {
|
|
IniFile(const char * const *list_group_names = nullptr);
|
|
|
|
bool SaveToDisk(const std::string &filename);
|
|
|
|
virtual FILE *OpenFile(const std::string &filename, Subdirectory subdir, size_t *size);
|
|
virtual void ReportFileError(const char * const pre, const char * const buffer, const char * const post);
|
|
};
|
|
|
|
#endif /* INI_TYPE_H */
|