add ChessEngine::tokenize method

artoj · artoj · commit e8708938873e · 2025-06-06T08:21:50.000+03:00
The `ChessEngine::tokenize` method that will replace the existing
`QStringRef` based tokenizer methods. The method returns a pair with the
token in the first element of the pair and the rest of the string in the
second element of the pair.
diff --git a/projects/lib/src/chessengine.cpp b/projects/lib/src/chessengine.cpp
@@ -26,6 +26,18 @@
 
 int ChessEngine::s_count = 0;
 
+std::pair<QStringView, QStringView> ChessEngine::tokenize(QStringView sv)
+{
+	if (sv.isEmpty())
+		return std::make_pair(QStringView(), QStringView());
+
+	auto index = sv.indexOf(QChar(' '));
+	if (index == -1)
+		return std::make_pair(sv, QStringView());
+
+	return std::make_pair(sv.mid(0, index), sv.mid(index, sv.size() - 1).trimmed());
+}
+
 QStringRef ChessEngine::nextToken(const QStringRef& previous, bool untilEnd)
 {
 	const QString* str = previous.string();
diff --git a/projects/lib/src/chessengine.h b/projects/lib/src/chessengine.h
@@ -131,6 +131,20 @@ class LIB_EXPORT ChessEngine : public ChessPlayer
 		virtual void kill();
 		
 	protected:
+		/*!
+		 * Reads the first whitespace-delimited token from a string
+		 * and returns a pair with the token in the first element
+		 * and the rest of the string in the second element of the pair.
+		 *
+		 * \note Leading and trailing whitespace need to be removed from
+		 * \a sv before calling this function.
+		 *
+		 * If \a sv doesn't contain any whitespace, the whole string
+		 * is returned in the first element of the pair.
+		 *
+		 * If \a sv is empty, a pair of empty QStringView is returned.
+		 */
+		static std::pair<QStringView, QStringView> tokenize(QStringView sv);
 		/*!
 		 * Reads the first whitespace-delimited token from a string
 		 * and returns a QStringRef reference to the token.
