TESTS: Add unit tests for UTF-8 encoding functions

tests/common/encoding_utf8.cpp

@@ -0,0 +1,72 @@
+/* xoreos - A reimplementation of BioWare's Aurora engine
+ *
+ * xoreos is the legal property of its developers, whose names
+ * can be found in the AUTHORS file distributed with this source
+ * distribution.
+ *
+ * xoreos 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; either version 3
+ * of the License, or (at your option) any later version.
+ *
+ * xoreos 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 xoreos. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+/** @file
+ *  Unit tests for UTF-8 encoding functions.
+ */
+
+#include "gtest/gtest.h"
+
+#include "src/common/error.h"
+#include "src/common/encoding.h"
+#include "src/common/memreadstream.h"
+#include "src/common/memwritestream.h"
+
+#include "tests/common/encoding.h"
+
+// The name and enum of the encoding we're testing
+#define XOREOS_ENCODINGNAME EncodingUTF8
+static const Common::Encoding kEncoding = Common::kEncodingUTF8;
+
+// -- General encoding feature tests, can't be generalized --
+
+GTEST_TEST(XOREOS_ENCODINGNAME, getBytesPerCodepoint) {
+	testSupport(kEncoding);
+
+	EXPECT_THROW(Common::getBytesPerCodepoint(kEncoding), Common::Exception);
+}
+
+GTEST_TEST(XOREOS_ENCODINGNAME, isValidCodePoint) {
+	testSupport(kEncoding);
+
+	EXPECT_TRUE(Common::isValidCodepoint(kEncoding, 0x20));
+}
+
+// -- Generalized encoding function tests --
+
+// Example string with terminating 0
+static const byte stringData0    [] = { 'F', 0xC3, 0xB6, 0xC3, 0xB6, 'b', 0xC3, 0xA4, 'r', '\0', };
+// Example string with terminating 0 and garbage following
+static const byte stringData0X   [] = { 'F', 0xC3, 0xB6, 0xC3, 0xB6, 'b', 0xC3, 0xA4, 'r', '\0', 'x' };
+// Example string without terminating 0 and with garbage following
+static const byte stringDataX    [] = { 'F', 0xC3, 0xB6, 0xC3, 0xB6, 'b', 0xC3, 0xA4, 'r', 'x' };
+// Example string with line end and garbage following
+static const byte stringDataLineX[] = { 'F', 0xC3, 0xB6, 0xC3, 0xB6, 'b', 0xC3, 0xA4, 'r', '\r', '\n', 'x' };
+
+// Number of bytes in the example string without terminating 0 and without garbage
+static const size_t stringBytes = 9;
+// Number of characters in the example string without terminating 0 and without garbage
+static const size_t stringChars = 6;
+
+// The example string encoded as UTF-8 (Foobar, o and a with diaereses)
+static const Common::UString stringUString = Common::UString("F""\xc3""\xb6""\xc3""\xb6""b""\xc3""\xa4""r");
+
+// The actual tests live here
+#include "tests/common/encoding_tests.h"

tests/common/rules.mk

@@ -124,3 +124,8 @@ check_PROGRAMS                           += tests/common/test_encoding_ascii
 tests_common_test_encoding_ascii_SOURCES  = tests/common/encoding_ascii.cpp
 tests_common_test_encoding_ascii_LDADD    = $(common_LIBS)
 tests_common_test_encoding_ascii_CXXFLAGS = $(test_CXXFLAGS)
+
+check_PROGRAMS                          += tests/common/test_encoding_utf8
+tests_common_test_encoding_utf8_SOURCES  = tests/common/encoding_utf8.cpp
+tests_common_test_encoding_utf8_LDADD    = $(common_LIBS)
+tests_common_test_encoding_utf8_CXXFLAGS = $(test_CXXFLAGS)