Allow redirection of lcf console messages

CMakeLists.txt

@@ -41,7 +41,9 @@ set(LCF_SOURCES
 	src/lmt_treemap.cpp
 	src/lmu_movecommand.cpp
 	src/lmu_reader.cpp
+	src/log.h
 	src/lsd_reader.cpp
+	src/log_handler.cpp
 	src/reader_flags.cpp
 	src/reader_lcf.cpp
 	src/reader_struct.h
@@ -208,6 +210,7 @@ set(LCF_HEADERS
 	src/lcf/lmt/reader.h
 	src/lcf/lmu/reader.h
 	src/lcf/lsd/reader.h
+	src/lcf/log_handler.h
 	src/lcf/reader_lcf.h
 	src/lcf/reader_util.h
 	src/lcf/reader_xml.h

Makefile.am

@@ -57,7 +57,9 @@ liblcf_la_SOURCES = \
 	src/lmt_treemap.cpp \
 	src/lmu_movecommand.cpp \
 	src/lmu_reader.cpp \
+	src/log.h \
 	src/lsd_reader.cpp \
+	src/log_handler.cpp \
 	src/reader_flags.cpp \
 	src/reader_lcf.cpp \
 	src/reader_struct.h \
@@ -219,6 +221,7 @@ lcfinclude_HEADERS = \
 	src/lcf/flag_set.h \
 	src/lcf/ini.h \
 	src/lcf/inireader.h \
+	src/lcf/log_handler.h \
 	src/lcf/reader_lcf.h \
 	src/lcf/reader_util.h \
 	src/lcf/reader_xml.h \

src/dbstring_struct.cpp

@@ -8,6 +8,7 @@
  */
 
 #include "lcf/dbstring.h"
+#include "log.h"
 #include "reader_struct.h"
 #include <iostream>
 
@@ -43,7 +44,7 @@ struct RawStruct<std::vector<DBString> > {
 void RawStruct<DBString>::ReadLcf(DBString& ref, LcfReader& stream, uint32_t length) {
 	stream.ReadString(ref, length);
 #ifdef LCF_DEBUG_TRACE
-	printf("  %s\n", ref.c_str());
+	fprintf(stderr, "  %s\n", ref.c_str());
 #endif
 }
 
@@ -106,9 +107,7 @@ void RawStruct<std::vector<DBString>>::ReadLcf(std::vector<DBString>& ref, LcfRe
 	}
 
 	if (stream.Tell() != endpos) {
-#ifdef LCF_DEBUG_TRACE
-		fprintf(stderr, "Misaligned!\n");
-#endif
+		Log::Warning("vector<string> Misaligned at 0x%" PRIx32 "", stream.Tell());
 		stream.Seek(endpos);
 	}
 }
@@ -177,7 +176,7 @@ class DbStringVectorXmlHandler : public XmlHandler {
 
 	void StartElement(XmlReader& stream, const char* name, const char** atts) {
 		if (strcmp(name, "item") != 0) {
-			stream.Error("Expecting %s but got %s", "item", name);
+			Log::Error("XML: Expecting %s but got %s", "item", name);
 			return;
 		}
 
@@ -191,7 +190,7 @@ class DbStringVectorXmlHandler : public XmlHandler {
 		}
 
 		if (id <= last_id || id < -1) {
-			stream.Error("Bad Id %d / %d", id, last_id);
+			Log::Error("XML: Bad Id %d / %d", id, last_id);
 			return;
 		}
 

src/encoder.cpp

@@ -10,6 +10,7 @@
 #include "lcf/encoder.h"
 #include "lcf/reader_util.h"
 #include "lcf/scope_guard.h"
+#include "log.h"
 #include <cstdio>
 #include <cstdlib>
 
@@ -86,7 +87,7 @@ void Encoder::Init() {
 	auto conv_runtime = ucnv_open(runtime_encoding, &status);
 
 	if (conv_runtime == nullptr) {
-		fprintf(stderr, "liblcf:  ucnv_open() error for encoding \"%s\": %s\n", runtime_encoding, u_errorName(status));
+		Log::Error("ucnv_open() error for encoding \"%s\": %s", runtime_encoding, u_errorName(status));
 		return;
 	}
 	status = U_ZERO_ERROR;
@@ -95,7 +96,7 @@ void Encoder::Init() {
 	auto conv_storage = ucnv_open(storage_encoding.c_str(), &status);
 
 	if (conv_storage == nullptr) {
-		fprintf(stderr, "liblcf:  ucnv_open() error for dest encoding \"%s\": %s\n", storage_encoding.c_str(), u_errorName(status));
+		Log::Error("ucnv_open() error for dest encoding \"%s\": %s", storage_encoding.c_str(), u_errorName(status));
 		return;
 	}
 
@@ -143,7 +144,7 @@ void Encoder::Convert(std::string& str, UConverter* conv_dst, UConverter* conv_s
 			&status);
 
 	if (U_FAILURE(status)) {
-		fprintf(stderr, "liblcf: ucnv_convertEx() error when encoding \"%s\": %s\n", src.c_str(), u_errorName(status));
+		Log::Error("ucnv_convertEx() error when encoding \"%s\": %s", src.c_str(), u_errorName(status));
 		_buffer.clear();
 	}
 

src/lcf/log_handler.h

@@ -0,0 +1,57 @@
+/*
+ * This file is part of liblcf. Copyright (c) liblcf authors.
+ * https://github.com/EasyRPG/liblcf - https://easyrpg.org
+ *
+ * liblcf is Free/Libre Open Source Software, released under the MIT License.
+ * For the full copyright and license information, please view the COPYING
+ * file that was distributed with this source code.
+ */
+
+#ifndef LCF_OUTPUT_H
+#define LCF_OUTPUT_H
+
+#include "string_view.h"
+#include "enum_tags.h"
+
+namespace lcf {
+namespace LogHandler {
+
+enum class Level {
+	Debug,
+	Warning,
+	Error,
+	Highest
+};
+
+static constexpr auto kLevelTags = lcf::makeEnumTags<Level>(
+	"Debug",
+	"Warning",
+	"Error",
+	"Highest"
+);
+
+using UserData = void*;
+using LogHandlerFn = void (*)(Level level, StringView message, UserData userdata);
+
+/**
+ * Sets the output handler for all lcf logging.
+ * The default handler prints to standard error.
+ *
+ * @param fn New output handler. nullptr for default handler.
+ * @param userdata Passed to the log handler function. Is not touched by liblcf.
+ */
+void SetHandler(LogHandlerFn fn, UserData userdata = nullptr);
+
+/**
+ * Only report issues that have at least this log level.
+ * Use Highest to disable logging.
+ * Default: Debug
+ *
+ * @param new_level New log level
+ */
+void SetLevel(Level new_level);
+
+} // namespace LogHandler
+} // namespace lcf
+
+#endif

src/lcf/reader_xml.h

@@ -54,11 +54,6 @@ class XmlReader {
 	 */
 	bool IsOk() const;
 
-	/**
-	 * Reports a parsing error.
-	 */
-	void Error(const char* fmt, ...);
-
 	/**
 	 * Parses the XML file.
 	 */

src/ldb_equipment.cpp

@@ -9,6 +9,7 @@
 
 #include "lcf/ldb/reader.h"
 #include "lcf/ldb/chunks.h"
+#include "log.h"
 #include "reader_struct.h"
 
 namespace lcf {
@@ -27,7 +28,7 @@ struct RawStruct<rpg::Equipment> {
  */
 void RawStruct<rpg::Equipment>::ReadLcf(rpg::Equipment& ref, LcfReader& stream, uint32_t length) {
 	if (length != 10) {
-		fprintf(stderr, "Equipment has incorrect size %" PRIu32 " (expected 10)\n", length);
+		Log::Warning("Equipment has incorrect size %" PRIu32 " (expected 10)", length);
 
 		LcfReader::Chunk chunk_info;
 		chunk_info.ID = 0x33;
@@ -85,7 +86,7 @@ class EquipmentXmlHandler : public XmlHandler {
 		else if (strcmp(name, "accessory_id") == 0)
 			field = &ref.accessory_id;
 		else {
-			stream.Error("Unrecognized field '%s'", name);
+			Log::Error("XML: Unrecognized field '%s'", name);
 			field = NULL;
 		}
 	}

src/ldb_eventcommand.cpp

@@ -9,6 +9,7 @@
 
 #include <string>
 #include <vector>
+#include "log.h"
 #include "reader_struct.h"
 #include "lcf/rpg/eventcommand.h"
 
@@ -108,7 +109,7 @@ class EventCommandXmlHandler : public XmlHandler {
 		else if (strcmp(name, "parameters") == 0)
 			field = Parameters;
 		else {
-			stream.Error("Unrecognized field '%s'", name);
+			Log::Error("XML: Unrecognized field '%s'", name);
 			field = None;
 		}
 	}
@@ -161,7 +162,7 @@ void RawStruct<std::vector<rpg::EventCommand> >::ReadLcf(
 
 		if (stream.Tell() >= endpos) {
 			stream.Seek(endpos, LcfReader::FromStart);
-			fprintf(stderr, "Event command corrupted at %" PRIu32 "\n", stream.Tell());
+			Log::Warning("Event command corrupted at %" PRIu32 "", stream.Tell());
 			for (;;) {
 				// Try finding the real end of the event command (4 0-bytes)
 				int i = 0;
@@ -216,7 +217,7 @@ class EventCommandVectorXmlHandler : public XmlHandler {
 
 	void StartElement(XmlReader& stream, const char* name, const char** /* atts */) {
 		if (strcmp(name, "EventCommand") != 0)
-			stream.Error("Expecting %s but got %s", "EventCommand", name);
+			Log::Error("XML: Expecting %s but got %s", "EventCommand", name);
 		ref.resize(ref.size() + 1);
 		rpg::EventCommand& obj = ref.back();
 		stream.SetHandler(new EventCommandXmlHandler(obj));

src/ldb_parameters.cpp

@@ -79,7 +79,7 @@ class ParametersXmlHandler : public XmlHandler {
 		else if (strcmp(name, "agility") == 0)
 			field = &ref.agility;
 		else {
-			stream.Error("Unrecognized field '%s'", name);
+			Log::Error("XML: Unrecognized field '%s'", name);
 			field = NULL;
 		}
 	}

src/ldb_reader.cpp

@@ -14,6 +14,7 @@
 #include "lcf/ldb/reader.h"
 #include "lcf/ldb/chunks.h"
 #include "lcf/reader_util.h"
+#include "log.h"
 #include "reader_struct.h"
 
 namespace lcf {
@@ -25,7 +26,7 @@ void LDB_Reader::PrepareSave(rpg::Database& db) {
 std::unique_ptr<lcf::rpg::Database> LDB_Reader::Load(StringView filename, StringView encoding) {
 	std::ifstream stream(ToString(filename), std::ios::binary);
 	if (!stream.is_open()) {
-		fprintf(stderr, "Failed to open LDB file `%s' for reading : %s\n", ToString(filename).c_str(), strerror(errno));
+		Log::Error("Failed to open LDB file '%s' for reading: %s", ToString(filename).c_str(), strerror(errno));
 		return nullptr;
 	}
 	return LDB_Reader::Load(stream, encoding);
@@ -34,7 +35,7 @@ std::unique_ptr<lcf::rpg::Database> LDB_Reader::Load(StringView filename, String
 bool LDB_Reader::Save(StringView filename, const lcf::rpg::Database& db, StringView encoding, SaveOpt opt) {
 	std::ofstream stream(ToString(filename), std::ios::binary);
 	if (!stream.is_open()) {
-		fprintf(stderr, "Failed to open LDB file `%s' for writing : %s\n", ToString(filename).c_str(), strerror(errno));
+		Log::Error("Failed to open LDB file '%s' for writing: %s", ToString(filename).c_str(), strerror(errno));
 		return false;
 	}
 	return LDB_Reader::Save(stream, db, encoding, opt);
@@ -43,7 +44,7 @@ bool LDB_Reader::Save(StringView filename, const lcf::rpg::Database& db, StringV
 bool LDB_Reader::SaveXml(StringView filename, const lcf::rpg::Database& db) {
 	std::ofstream stream(ToString(filename), std::ios::binary);
 	if (!stream.is_open()) {
-		fprintf(stderr, "Failed to open LDB XML file `%s' for writing : %s\n", ToString(filename).c_str(), strerror(errno));
+		Log::Error("Failed to open LDB XML file '%s' for writing: %s", ToString(filename).c_str(), strerror(errno));
 		return false;
 	}
 	return LDB_Reader::SaveXml(stream, db);
@@ -52,7 +53,7 @@ bool LDB_Reader::SaveXml(StringView filename, const lcf::rpg::Database& db) {
 std::unique_ptr<lcf::rpg::Database> LDB_Reader::LoadXml(StringView filename) {
 	std::ifstream stream(ToString(filename), std::ios::binary);
 	if (!stream.is_open()) {
-		fprintf(stderr, "Failed to open LDB XML file `%s' for reading : %s\n", ToString(filename).c_str(), strerror(errno));
+		Log::Error("Failed to open LDB XML file '%s' for reading: %s", ToString(filename).c_str(), strerror(errno));
 		return nullptr;
 	}
 	return LDB_Reader::LoadXml(stream);
@@ -61,17 +62,17 @@ std::unique_ptr<lcf::rpg::Database> LDB_Reader::LoadXml(StringView filename) {
 std::unique_ptr<lcf::rpg::Database> LDB_Reader::Load(std::istream& filestream, StringView encoding) {
 	LcfReader reader(filestream, ToString(encoding));
 	if (!reader.IsOk()) {
-		LcfReader::SetError("Couldn't parse database file.\n");
+		LcfReader::SetError("Couldn't parse database file.");
 		return nullptr;
 	}
 	std::string header;
 	reader.ReadString(header, reader.ReadInt());
 	if (header.length() != 11) {
-		LcfReader::SetError("This is not a valid RPG2000 database.\n");
+		LcfReader::SetError("This is not a valid RPG2000 database.");
 		return nullptr;
 	}
 	if (header != "LcfDataBase") {
-		fprintf(stderr, "Warning: This header is not LcfDataBase and might not be a valid RPG2000 database.\n");
+		Log::Warning("Header %s != LcfDataBase and might not be a valid RPG2000 database.", header.c_str());
 	}
 	auto db = std::make_unique<lcf::rpg::Database>();
 	db->ldb_header = header;
@@ -91,7 +92,7 @@ bool LDB_Reader::Save(std::ostream& filestream, const lcf::rpg::Database& db, St
 	const auto engine = GetEngineVersion(db);
 	LcfWriter writer(filestream, engine, ToString(encoding));
 	if (!writer.IsOk()) {
-		LcfReader::SetError("Couldn't parse database file.\n");
+		LcfReader::SetError("Couldn't parse database file.");
 		return false;
 	}
 	std::string header;