1 files changed, 168 insertions, 0 deletions
diff --git a/src/core/common/TextCursor.hpp b/src/core/common/TextCursor.hpp
new file mode 100644
index 0000000..2633345
--- /dev/null
+++ b/src/core/common/TextCursor.hpp
@@ -0,0 +1,168 @@
+/*
+    Ousía
+    Copyright (C) 2014, 2015  Benjamin Paaßen, Andreas Stöckel
+
+    This program 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.
+
+    This program 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 this program.  If not, see <http://www.gnu.org/licenses/>.
+*/
+
+#ifndef _OUSIA_TEXT_CURSOR_HPP_
+#define _OUSIA_TEXT_CURSOR_HPP_
+
+namespace ousia {
+namespace TextCursor {
+
+/**
+ * Type used for representing line or column positions.
+ */
+using PosType = unsigned int;
+
+/**
+ * Struct representing a position within the text. A position is defined by a
+ * byte offset (which is always reproducable), a line number and a column
+ * number.
+ */
+struct Position {
+	/**
+	 * Current line, starting with one.
+	 */
+	PosType line;
+
+	/**
+	 * Current column, starting with one.
+	 */
+	PosType column;
+
+	/**
+	 * Current byte offset.
+	 */
+	size_t offs;
+
+	/**
+	 * Default constructor of the Position struct, initializes all memebers
+	 * with zero.
+	 */
+	Position() : line(0), column(0), offs(0) {}
+
+	/**
+	 * Creates a new Position struct with only a line and no column.
+	 *
+	 * @param line is the line number.
+	 * @param column is the column number.
+	 */
+	Position(PosType line) : line(line), column(0), offs(0) {}
+
+	/**
+	 * Creates a new Position struct with a line and column.
+	 *
+	 * @param line is the line number.
+	 * @param column is the column number.
+	 */
+	Position(PosType line, PosType column) : line(line), column(column), offs(0)
+	{
+	}
+
+	/**
+	 * Creates a new Position struct with a line, column and byte offset.
+	 *
+	 * @param line is the line number.
+	 * @param column is the column number.
+	 * @param offs is the byte offset.
+	 */
+	Position(PosType line, PosType column, size_t offs)
+	    : line(line), column(column), offs(offs)
+	{
+	}
+
+	/**
+	 * Returns true, if the line number is valid, false otherwise.
+	 *
+	 * @return true for valid line numbers.
+	 */
+	bool hasLine() const { return line > 0; }
+
+	/**
+	 * Returns true, if the column number is valid, false otherwise.
+	 *
+	 * @return true for valid column numbers.
+	 */
+	bool hasColumn() const { return column > 0; }
+};
+
+/**
+ * Represents the current context a CharReader is in. Used for building error
+ * messages.
+ */
+struct Context {
+	/**
+	 * Set to the content of the current line.
+	 */
+	std::string text;
+
+	/**
+	 * Relative position (in characters) within that line. May point to
+	 * locations beyond the text content.
+	 */
+	PosType relPos;
+
+	/**
+	 * Set to true if the beginning of the line has been truncated (because
+	 * the reader position is too far away from the actual position of the
+	 * line).
+	 */
+	bool truncatedStart;
+
+	/**
+	 * Set to true if the end of the line has been truncated (because the
+	 * reader position is too far away from the actual end position of the
+	 * line.
+	 */
+	bool truncatedEnd;
+
+	/**
+	 * Default constructor, initializes all members with zero values.
+	 */
+	Context() : text(), relPos(0), truncatedStart(false), truncatedEnd(false) {}
+
+	/**
+	 * Constructor of the Context class.
+	 *
+	 * @param text is the current line the text cursor is at.
+	 * @param relPos is the relative position of the text cursor within that
+	 * line.
+	 * @param truncatedStart specifies whether the text was truncated at the
+	 * beginning.
+	 * @param truncatedEnd specifies whether the text was truncated at the
+	 * end.
+	 */
+	Context(std::string text, size_t relPos, bool truncatedStart,
+	        bool truncatedEnd)
+	    : text(std::move(text)),
+	      relPos(relPos),
+	      truncatedStart(truncatedStart),
+	      truncatedEnd(truncatedEnd)
+	{
+	}
+
+	/**
+	 * Returns true the context text is not empty.
+	 *
+	 * @return true if the context is valid and e.g. should be printed.
+	 */
+	bool valid() const { return !text.empty(); }
+};
+}
+}
+
+#endif /* _OUSIA_TEXT_CURSOR_HPP_ */
+